Skip to main content
POST
/
candidates
/
{id}
/
contact-identifiers
Create contact identifier for a candidate
curl --request POST \
  --url https://api.gospott.com/candidates/{id}/contact-identifiers \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <api-key>' \
  --data '
{
  "contactType": "email",
  "purpose": "personal",
  "identifier": "<string>",
  "isPrimary": true
}
'
{
  "duplicates": [
    {
      "contactType": "email",
      "identifier": "<string>",
      "contactIdentifierId": "<string>",
      "takenBy": {
        "name": "<string>",
        "id": "<string>",
        "type": {}
      }
    }
  ]
}

Authorizations

x-api-key
string
header
required

API key for authentication. Get your API key from Settings → API Keys in your Spott dashboard.

Path Parameters

id
string
required

Body

application/json
contactType
enum<string>
required
Available options:
email,
phone,
linkedin,
instagram,
facebook,
x
purpose
enum<string> | null
required
Available options:
personal,
work
identifier
string
required
isPrimary
boolean

Response

Successfully created contact identifier for the candidate.