Add a contact to an account
Creates a new contact and associates it with the given account. Set is_primary: true to
automatically demote the existing primary contact. The contact is scoped to the authenticated
entity (Layer 1 isolation); contact data never crosses entity boundaries.
Requires accounts:write scope.
Field aliases: role accepted as alias for title; phone_main accepted as alias for phone.
Authorizations
API key issued per entity via Settings > Developers > API Keys.
Each key carries scopes (e.g. orders:read, products:write).
Bearer token format: Authorization: Bearer ark_live_ent_Test keys use ark_test_ent_. Both are issued per entity
via Settings > Developers > API Keys.
Headers
255Path Parameters
Body
Contact payload accepted by both standalone contact endpoints and the atomic-create path in POST /v1/accounts.
Field aliases (all paths, all operations):
roleaccepted as alias fortitle(public API convenience)phone_mainaccepted as alias forphone
FIX 2026-05-15 (NEW-GAP-API-V1-ADDRESS-AND-CONTACT-FIELD-MAPPING-INCONSISTENT): Aliases now work in standalone POST/PATCH endpoints (previously only worked in atomic-create).
Phone number. Also accepted as phone_main (alias).
Alias for phone.
Job title or role. Also accepted as role (alias).
Alias for title.
Response
Contact created
A person contact associated with an account.

