---
title: "Add or update a profile."
method: POST
path: "/profiles"
tags: ["Add or Update"]
---

# Add or update a profile.

`POST /profiles`

Add or update a profile. Recommendations will be updated shortly to reflect these changes.

## Request body

- Profile
  - `external_id` string, required — The unique entity id.
  - `client_data` object — Optional client-specific data
  - `addresses` string[] — The addresses closest to which the profile is looking for work, including the country name. Note this is not the same as the addresses where the profile is looking for work.
  - `geocoordinates` GeoPoint[] — Each element in the list characterizes a geo point.
    - `lat` number, required — Example: lat=50.8503396. Latitude in degrees following the WGS84 standard. Positive numbers correspond to latitude North.
    - `lon` number, required — Example: long=4.3517103. Longitude in degrees following the WGS84 standard. Positive numbers correspond to longitude East.
  - `name` string — The profile's full name.
  - `picture_url` string, uri — The profile's picture URL.
  - `website_url` string, uri — The profile's website URL.
  - `social_media_profile_urls` string[] — The social media profiles of the profile.
  - `phone` string — The profile's phone number.
  - `email` union — The email addresses of the profile.
    - string, email
    - string
  - `gender` 'F' | 'M' | 'X' — An enumeration.
  - `birthdate` string, date-time — The birthdate of the profile in ISO 8601 (https://en.wikipedia.org/wiki/ISO_8601).
  - `description` string — A description of this profile.
  - `highest_educational_level` string — Highest education levels attained by this profile as defined in ISCED 2011 levels (https://en.wikipedia.org/wiki/International_Standard_Classification_of_Education, http://uis.unesco.org/sites/default/files/documents/international-standard-classification-of-education-isced-2011-en.pdf). Preferably as granular as possible.
  - `languages` ValidateApiSpecLanguage[] — Language proficiencies of this profile. Languages must be two-letter codes defined in ISO 639-1 (https://en.wikipedia.org/wiki/List_of_ISO_639-1_codes). Proficiencies are on the ILR scale (https://en.wikipedia.org/wiki/ILR_scale).
    - `language` string, required
    - `proficiency` 'ELEMENTARY' | 'LIMITED_WORKING' | 'PROFESSIONAL_WORKING' | 'FULL_PROFESSIONAL' | 'NATIVE_OR_BILINGUAL' — An enumeration.
  - `certificates` string[] — A list of descriptions of the profile's certificates.
  - `skills` string[] — A list of short descriptions of the profile's skills.
  - `skill_tags` SkillTag[] — A list of the profile's skill tags.
    - `name` string, required
    - `experience` 'JUNIOR' | 'MEDIOR' | 'SENIOR' — An enumeration.
    - `type` 'GENERATED' | 'CONFIRMED' | 'REJECTED', required — An enumeration.
  - `interests` string[] — A list of descriptions of the profile's interests.
  - `desired_jobs` string[] — A list of desired jobs titles or short descriptions.
  - `undesired_jobs` string[] — A list of undesired jobs titles or short descriptions.
  - `desired_job_seniority_levels` ExperienceLevel[] — The desired seniority for a job.
  - `degrees` Degree[] — A list of attained or in-progress degrees. If the degree is in-progress, leave the attendanceEndDateTime blank. Make sure to not include degrees that are not attained or in-progress!
    - `title` string, required
    - `institution` string
    - `description` string
    - `level` string — Education level attained by this degree as defined in ISCED 2011 levels (https://en.wikipedia.org/wiki/International_Standard_Classification_of_Education, http://uis.unesco.org/sites/default/files/documents/international-standard-classification-of-education-isced-2011-en.pdf). Preferably as granular as possible.
    - `attendance_start_datetime` union
      - string, date-time
      - string
    - `attendance_end_datetime` union
      - string, date-time
      - string
  - `experiences` Experience[] — A list of work experience. If the job is in-progress, leave the job_end_datetime blank.
    - `title` string, required
    - `organization_name` string
    - `organization_url` string, uri
    - `organization_vatin` string — The organization VAT identification number, or VATIN (https://en.wikipedia.org/wiki/VAT_identification_number).
    - `description` string
    - `job_start_datetime` union
      - string, date-time
      - string
    - `job_end_datetime` union
      - string, date-time
      - string
  - `relationship_preferences` RelationshipType[] — The desired employment relationship.
  - `location_preferences` LocationType[] — The desired employment location.
  - `employment_term_preferences` TermType[] — The desired employment term.
  - `capacity_preferences` CapacityType[] — The desired employment capacity.
  - `workday_preferences` DaysType[] — The desired employment schedule.
  - `hours_preferences` HoursType[] — The desired employment hours.
  - `last_updated_datetime` union — The localized timestamp (including timezone) this profile posting was most recently updated in ISO 8601 (https://en.wikipedia.org/wiki/ISO_8601).
    - string, date-time
    - string
  - `publication_datetime` union — The localized timestamp (including timezone) this profile posting was most recently published in ISO 8601 (https://en.wikipedia.org/wiki/ISO_8601).
    - string, date-time
    - string
  - `expiration_datetime` union — The localized timestamp (including timezone) this profile posting expires in ISO 8601 (https://en.wikipedia.org/wiki/ISO_8601). If null, this profile does not expire.
    - string, date-time
    - string
  - `may_be_recommended` boolean — Whether this profile may be recommended (subject to the posting publish and expire times).
  - `may_receive_recommendations` boolean — Whether this profile may receive recommendations.
  - `attachments` Attachment[]
    - `filename` string, required — The name of the file. We support .pdf, .docx and .doc
    - `content` string, required — The attachment content base-64 encoded. We support .pdf, .docx and .doc.

## Response `200`

Successful Response

- unknown

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/talentapi/apis/talent-api-api-reference.md) · [All operations](https://skmtc.net/talentapi/apis/talent-api-api-reference/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/talentapi/talent-api-api-reference/revisions/0798d0794573/schema)