contacts

Create a contact (v2)

Changed on

Create ONE contact. The common case — TanStack DB optimistic mutations, mobile add-contact, MCP tools. Requires Idempotency-Key. Returns { data: { contact: {...} } } with status 201. For bulk create, use POST /v2/contacts/batch.

post/v2/contacts/

Request

  • Base URL: https://api.prod.getdex.com
  • URL: https://api.prod.getdex.com/v2/contacts/
  • Auth: HTTP bearer

Headers

Idempotency-Keystring required
Example:01HV8N6X7K3P9Q5R2T4Y6W8Z0A

Required. UUID per logical operation, reused on every retry. See apps/rest-api/src/shared/idempotency.ts for the full contract. Missing → 400 BadRequest; same key + different body → 409 Conflict.

Request body

full_namestring
first_namestring
last_namestring
descriptionstring
job_titlestring
legacy_locationstring
companystring
educationstring
starredboolean
source'linkedin_sync' | 'facebook_import' | 'cal_ingest' | 'email_ingest' | 'web_import' | 'csv_import' | 'whatsapp_sync' | 'imessage_sync' | 'phone_calls_sync' | 'mobile' | 'mobile_import' | 'instagram_sync' | 'oauth_interaction' | 'granola_sync'
priority_tierinteger
image_urlstring uri
image_sourcestring uri
business_card_urlstring uri
websiteunknown
birthdaystring date
birthday_yearnumber
frequencystring
last_seen_atunknown
first_met_atunknown
never_keep_in_touchboolean
next_reminder_atunknown
linkedinstring
twitterstring
facebookstring
instagramstring
telegramstring
tiktokstring
youtubestring
whatsapp_message_linkstring
whatsapp_message_snippetstring
whatsapp_last_message_atunknown
imessage_message_linkstring
imessage_message_snippetstring
imessage_last_message_atunknown
linkedin_message_linkstring
linkedin_last_message_snippetstring
linkedin_last_message_atunknown
linkedin_dataobject
instagram_message_linkstring
instagram_message_snippetstring
instagram_last_message_atunknown
gmail_last_interaction_atunknown
gmail_last_interaction_provider_idstring
gmail_last_interaction_subjectstring
gmail_last_interaction_provider'GOOGLE' | 'OFFICE365'
gcal_last_interaction_atunknown
gcal_last_interaction_provider_idstring
gcal_last_interaction_titlestring
gcal_last_interaction_provider'GOOGLE' | 'OFFICE365'
phone_call_last_interaction_atunknown
phone_call_interaction_snippetstring
web_search_summaryobject

Response

Created

Changes

  • 62f85fb89e0eRevision changes
    • info

      added the optional property // to the response with the status

  • 453bed03b3f2Revision changes
    • info

      added the optional property // to the response with the status

    • info

      added the optional property // to the response with the status