Create a native contact
Adds one person to this sub-account.
phone is the only required field. It is normalised to E.164. A ten-digit number is read as North American, and any other needs + or 00. A number that cannot be normalised is refused.
A number already in the sub-account is refused. To change an existing contact, use PATCH /api/native-contacts/{contactId}.
customFields takes the keys from GET /api/native-contacts/fields, and each value must fit its field’s type. An unknown key is an error.
A new contact can start one active campaign whose trigger matches, such as “New contact” or a field being set.
Do-not-call history outlives the contact. If this number was on do-not-call and its contact was deleted, the new contact keeps that decision, with its date, reason and source, and suppressedFromHistory: true. It will not be dialled.
Cookie-auth callers must send the x-csrf-token header.
Required API key scope: contacts:write.
Authorizations
Query Parameters
Body
The person.
Response
The contact as stored. suppressedFromHistory appears when this number was already on do-not-call.
