Skip to main content
POST
/
rest
/
v2
/
profiles
Creates or update a profile
curl --request POST \
  --url https://functions.prod.jarvi.tech/v1/public-api/rest/v2/profiles \
  --header 'Content-Type: application/json' \
  --header 'X-API-KEY: <api-key>' \
  --data '
{
  "projectId": "713a8005-e54d-4ee3-b6a4-89b27167dde6",
  "firstName": "Quentin",
  "lastName": "Decré",
  "emailAddresses": "[email protected], [email protected]",
  "phoneNumbers": "+33752626164,0240493773",
  "linkedinUrl": "https://www.linkedin.com/in/quentindecre/",
  "historyEntrySubject": "Interview notes",
  "historyEntryMessage": "The message of the historyentry you want to show in the profile’s Jarvi history",
  "resumesFiles": [
    {
      "fileName": "cv.pdf",
      "data": "data:@file/pdf;base64,JVBERi0......AABTLAAAAAA="
    }
  ],
  "files": [
    {
      "fileName": "motivation.docx",
      "data": "data:@file/vnd.openxmlformats-officedocument.wordprocessingml.document;base64,UEsDBBQ......AABTLAAAAAA="
    }
  ],
  "externalId": "Your id. Will merge with exisiting profile with same externalId",
  "id": "Jarvi uuid. Will merge with exisiting profile with same id",
  "location": "Rennes, France",
  "headline": "Co-Founder Jarvi",
  "currentCompanyName": "Jarvi",
  "currentCompanyId": "Jarvi",
  "currentPosition": "Co-founder",
  "<any custom field uuid>": "My custom field value for this profile",
  "historyEntryType": "2788baea-1119-46d9-8e60-af9d6a1268e1"
}
'
{
  "message": "Profile saved successfully",
  "taskId": "0b538428-7652-4243-baaf-3867803d7007",
  "profileId": "d730cca9-d8b0-49e7-b2e0-c58c1bb7af9f"
}
Sie müssen Ihren privaten API-Schlüssel für diese Anfrage verwenden.
Sie können alle Informationen jedes Profils vollständig mit Benutzerdefinierten Feldern anpassen. Klicken Sie auf diesen Link, um zu verstehen, wie Sie Informationen in benutzerdefinierten Feldern lesen und schreiben können.

Authorizations

​
X-API-KEY
string
header
required

Body

application/json
​
projectId
string

(rarely used) As for the reference id, but with the Jarvi internal project id. You can use projectId, referenceId or none of them if you want to create a profile without linking it to a project

Example:

"713a8005-e54d-4ee3-b6a4-89b27167dde6"

​
firstName
string

If not provided, will be extracted from the resume or Linkedin URL. If no resume or Linkedin URL, will be required

Example:

"Quentin"

​
lastName
string

If not provided, will be extracted from the resume or Linkedin URL. If no resume or Linkedin URL, will be required

Example:

"Decré"

​
emailAddresses
string

Multiple email addresses separated by a comma. If not provided, will be extracted from the resume or Linkedin URL.

Example:

"[email protected], [email protected]"

​
phoneNumbers
string

Multiple phone numbers separated by a comma. If not provided, will be extracted from the resume or Linkedin URL.

Example:

"+33752626164,0240493773"

​
linkedinUrl
string

The linkedin URL of the profile. If provided, Jarvi will extract the profile informations from the linkedin profile

Example:

"https://www.linkedin.com/in/quentindecre/"

​
historyEntrySubject
string

The subject of the historyentry you want to show in the profile’s Jarvi history.

Example:

"Interview notes"

​
historyEntryMessage
string

The message of the historyentry you want to show in the profile’s Jarvi history

Example:

"The message of the historyentry you want to show in the profile’s Jarvi history"

​
resumesFiles
object[]

The resume(s) of the profile. Will be parsed by Jarvi. Remember to convert to base64 before sending

​
files
object[]

(rarely used) Any file you want to upload with the profile. Will not be parsed. Remember to convert to base64 before sending

​
externalId
string

(rarely used) Your id. Will merge with exisiting profile with same externalId

Example:

"Your id. Will merge with exisiting profile with same externalId"

​
id
string

(rarely used) Jarvi uuid. Will merge with exisiting profile with same id

Example:

"Jarvi uuid. Will merge with exisiting profile with same id"

​
location
string

The location of the profile. If not provided, will be extracted from the resume or Linkedin URL

Example:

"Rennes, France"

​
headline
string

The headline of the profile. If not provided, will be extracted from the resume or Linkedin URL

Example:

"Co-Founder Jarvi"

​
currentCompanyName
string

The current company name of the profile. If not provided, will be extracted from the resume or Linkedin URL. If a company with this name exists, the profile will be associated as contact of this company

Example:

"Jarvi"

​
currentCompanyId
string

If a company with this id exists, the profile will be associated as contact of this company

Example:

"Jarvi"

​
currentPosition
string

The current job title of the profile. If not provided, will be extracted from the resume or Linkedin URL

Example:

"Co-founder"

​
<any custom field uuid>
string

Any custom field you want to add to the profile. You can find the uuid of the custom field in the Jarvi settings. If you want to provide multiple values, you can separate them with a comma

Example:

"My custom field value for this profile"

​
historyEntryType
string

The type of the historyentry you want to show in the profile’s Jarvi history. It can be one of EVENT_SCHEDULED, EMAIL_SENT, EMAIL_RECEIVED, LINKEDIN_MESSAGE_SENT, LINKEDIN_MESSAGE_RECEIVED, LINKEDIN_INMAIL_SENT, LINKEDIN_INMAIL_RECEIVED, LINKEDIN_INVITATION_SENT, PHONECALL, PHONECALL_MISSED, SMS_SENT, SMS_RECEIVED, WHATSAPP_SENT, WHATSAPP_RECEIVED, TELEGRAM_SENT, TELEGRAM_RECEIVED, JOB_APPLICATION, LINKEDIN_NOTE, OTHER, or the uuid of any custom interaction type you may have created.

Example:

"2788baea-1119-46d9-8e60-af9d6a1268e1"

Response

The application has been saved

​
message
string
Example:

"Profile saved successfully"

​
taskId
string
Example:

"0b538428-7652-4243-baaf-3867803d7007"

​
profileId
string
Example:

"d730cca9-d8b0-49e7-b2e0-c58c1bb7af9f"