INinkbox
Contacts

Create Contact

Changed on
post/api/v1/contacts/

Request

  • Base URL
    https://api.inkbox.ai (the document declares no server; this is the origin it was published from)
  • URL
    https://api.inkbox.ai/api/v1/contacts/
  • Auth
    • API key in header X-API-Key
    • or HTTP bearer

Headers

Idempotency-Keystring nullable

Request body

preferred_namestring nullable
name_prefixstring nullable
given_namestring nullable
middle_namestring nullable
family_namestring nullable
name_suffixstring nullable
company_namestring nullable
job_titlestring nullable
birthdaystring date nullable
notesstring nullable
access_identity_idsstring[] nullable

Deprecated. Non-null values are rejected; use contact communication policies instead.

Example request

{
  "phones": [
    {
      "value_e164": "+15551234567"
    }
  ]
}

Response

Successful Response

idstring uuid required
organization_idstring required
preferred_namestring nullable required
name_prefixstring nullable required
given_namestring nullable required
middle_namestring nullable required
family_namestring nullable required
name_suffixstring nullable required
company_namestring nullable required
job_titlestring nullable required
birthdaystring date nullable required
notesstring nullable required
creation_source'manual' | 'vcard' | 'communication' | 'backfill' required
review_status'unreviewed' | 'confirmed' required
reviewed_atstring date-time nullable required
reviewed_bystring nullable required
preferred_name_source'manual' | 'vcard' | 'provider' | 'mail_header' | 'identifier_fallback' required
preferred_name_locked_atstring date-time nullable required
created_by_identity_idstring uuid nullable required
merged_into_contact_idstring uuid nullable required
is_auto_createdboolean required
is_confirmedboolean required
status'active' | 'paused' | 'deleted' required
created_atstring date-time required
updated_atstring date-time required
memory_countinteger required

Changes

  • 77c7e3ee70cfRevision changes
    • info

      added to the response body allOf list for the response status

    • info

      removed subschema #1 from the response body allOf list for the response status

  • a0729c3c4a0bRevision changes
    • info

      added subschema #1 to the response body allOf list for the response status

    • info

      removed from the response body allOf list for the response status