Mark contact internal
Authentication required. Intended for customer-facing agency administrators and project users. Results and actions are tenant-scoped to projects visible to the caller.
Marks a contact as one of your own test leads. Its calls are left out of every performance figure on the dashboard — lead counts, booking and transfer rates, pickup, trends and the heatmap — so a number you dialled to check an agent works does not read as pipeline.
Cost figures are deliberately unaffected: the minutes were really spent and really billed, so removing them would put the dashboard at odds with your wallet.
The contact still gets called. This changes reporting only.
Cookie-auth callers must send the x-csrf-token header.
Required API key scope: contacts:write.
Authorizations
Send your API key as Authorization: Bearer YOUR_API_KEY.
Body
The project, and the contact identified by id or phone number.
- Option 1
- Option 2
Identify the contact by contactId, by phoneNumber, or by both. At least one is required. Around 2% of contacts carry no id and are reachable only by number.
Stable project location id used to tenant-scope the contact action.
1"loc_abc123"
Stable contact id. Preferred when the contact has one.
"contact_123"
Optional display label. Never used as tenant identity.
"Acme Clinic"
Contact phone number. Required when the contact has no id, and worth sending alongside one to reach records written before that id existed.
"+15551234567"
