Power Automate integration · Custom connector
Parse resumes in Power Automate
Import the HireLayer connector once, then parse CVs from Outlook attachments, SharePoint libraries or OneDrive folders, score candidates against a job, and write the results to Excel, Dataverse, Teams or your ATS.
- Connector file
- OpenAPI 2.0 (Swagger), 6 actions
- Authentication
- API key, asked when you create the connection
- Works in
- Power Automate, Power Apps, Copilot Studio
- License
- Custom connectors need a Premium plan
- 1When a new email arrivesPower AutomateOutlook trigger with attachments, or When a file is created in a SharePoint library or a OneDrive folder.
- 2HireLayer · Parse a resumeHireLayerMap the attachment content into Resume file. The action returns the candidate as dynamic content.
- 3HireLayer · Match a candidate to a jobHireLayerScores Full text against the job description and returns a score from 0 to 1.
- 4Store and notifyPower AutomateAdd a row to an Excel table or a Dataverse table, then post an adaptive card in Teams.
Use cases
Flows you can build
Recruiting mailbox to Excel
Each CV sent to the shared recruiting mailbox becomes a row in an Excel table on SharePoint, with contact details, current title, languages and skills.
SharePoint CV library
When a recruiter drops a CV into a document library, the flow parses it and fills the library columns, so the list view becomes searchble.
Shortlists in Teams
Score each applicant against the job and post the strong matches to the hirring channel with the summary and the main criteria met.
Recruiting copilot
The same connector is available in Copilot Studio, so an agent can parse a CV or rank candidates when a recruiter asks.
Setup
Import the connector
Creating a custom connector needs a Power Automate plan with Premium connectors. Each user who runs the flow creates a connection with their own HireLayer key.
- 1
Download the definition
Download the HireLayer connector file (OpenAPI 2.0). It describes six actions: Parse a resume, Extract job criteria, Match a candidate to a job, Rank candidates, Normalize skills and Get account.
- 2
Create the custom connector
In Power Automate, open Custom connectors → New custom connector → Import an OpenAPI file, name it HireLayer and select the file. Security is already set to API key in the X-API-Key header. Select Create connector.
- 3
Create a connection
Add a HireLayer action to a flow and paste your API key when asked. Get account is free, so it is a safe first test.
- 4
Map a file
In Parse a resume, map Attachments Content from Outlook or File Content from SharePoint or OneDrive into Resume file. The response appears as dynamic content: Full name, Email, Phone number, Full text and more.
Field mapping
Dynamic content after Parse a resume
| HireLayer field | Dynamic content label | Note |
|---|---|---|
| info_candidate.full_name | Full name | |
| info_candidate.email | ||
| info_candidate.phone_number | Phone number | |
| info_candidate.job_title | Job title | |
| work_experiences[] | Work experiences | Use Apply to each |
| info_resume.text | Full text | Input of Match a candidate to a job |
Example
What the connector declares
The file is a standard OpenAPI 2.0 definition. You can read it before importing it, and edit the action names if your team prefers other labels.
"/api/v3/parser": {
"post": {
"operationId": "ParseResume",
"summary": "Parse a resume",
"consumes": ["multipart/form-data"],
"parameters": [
{ "name": "file", "in": "formData", "type": "file", "required": true,
"x-ms-summary": "Resume file" },
{ "name": "application_id", "in": "formData", "type": "string",
"x-ms-summary": "Application ID" },
{ "name": "do_not_store_data", "in": "formData", "type": "string",
"enum": ["true", "false"], "x-ms-summary": "Do not store the file" }
]
}
}Limits
Good to know
Within the 2-minute limit
Power Automate waits up to 120 seconds for an action. Parsing usually takes about 35 seconds, so the action returns the result directly.
Test inside a flow
The Test tab of the connector editor does not always send files correctly. Test Parse a resume from a flow with a real attachment instead.
Retries
Power Automate retries actions that fail with a 5xx or 429 status. Failed calls are not charged, so retries never bill a parse twice for an error.
Not a certified connector
This is a custom connector you import into your environment. It is not listed in the Microsoft conector gallery.
HireLayer APIs used on this page
FAQ
HireLayer and Power Automate: questions
Is there a HireLayer connector for Power Automate?
Yes, as a custom connector: download the OpenAPI file from this page and import it in Custom connectors. It is not a certified connector in the Microsoft gallery.
Can Power Automate parse resumes from Outlook attachments?
Yes. Use When a new email arrives with Include attachments, loop over the attachments, and map each attachment’s content into HireLayer · Parse a resume.
Do I need a Premium license?
Yes. Microsoft classes custom connectors as Premium, so the person who runs the flow needs a plan that includes Premium connectors.
Can I use it in Copilot Studio?
Yes. A custom connector created in an environment is also available to Power Apps and Copilot Studio in that environment.
Can I use it in Azure Logic Apps?
Yes. Create a Logic Apps custom connector from the same OpenAPI file. Logic Apps Consumption also waits up to 120 seconds per action.
Connect Power Automate to HireLayer today
The Free plan includes 50 credits a month, no card required. One successful call is one credit, on every API.