Skip to Content
Wapitick developers

contacts

Customers: identities, consent, tags, stages, merge, erase.

Customers: identities, consent, tags, stages, merge, erase.

MethodPathOperationScopeTest mode
GET/v1/contactscontacts_list: List and filter contactscontacts:readyes
POST/v1/contactscontacts_create: Create a contactcontacts:writeyes
POST/v1/contacts:bulk-assigncontacts_bulk_assign: Give many customers to one staff membercontacts:write-
POST/v1/contacts:upsertcontacts_upsert: Create or update a contact by identity (idempotent)contacts:writeyes
DELETE/v1/contacts/{contact_id}contacts_delete: Erase a contact (DSR: tombstone content, keep billing metadata)contacts:deleteyes
GET/v1/contacts/{contact_id}contacts_get: Get a contactcontacts:readyes
PATCH/v1/contacts/{contact_id}contacts_update: Update a contact (JSON Merge Patch)contacts:writeyes
GET/v1/contacts/{contact_id}/attributioncontacts_get_attribution: Click-to-WhatsApp / lead-ad attributioncontacts:read-
GET/v1/contacts/{contact_id}/consentscontacts_list_consents: Consent recordscontacts:readyes
POST/v1/contacts/{contact_id}/consentscontacts_record_consent: Record an opt-in or opt-out with proofcontacts:writeyes
GET/v1/contacts/{contact_id}/identitiescontacts_list_identities: List a contact's identitiescontacts:read-
POST/v1/contacts/{contact_id}/identitiescontacts_add_identity: Add an identity (phone, email, BSUID, IG/Messenger id)contacts:write-
DELETE/v1/contacts/{contact_id}/identities/{identity_id}contacts_remove_identity: Remove an identitycontacts:write-
POST/v1/contacts/{contact_id}/mergecontacts_merge: Merge duplicates into this contactcontacts:write-
POST/v1/contacts/{contact_id}/opt-outcontacts_opt_out: Record a staff opt-out (marketing) and request the confirmation messagecontacts:writeyes
POST/v1/contacts/{contact_id}/stagecontacts_set_stage: Move the contact to a pipeline stage (writes stage history)contacts:write-
GET/v1/contacts/{contact_id}/stage-historycontacts_stage_history: All stage transitions (retained for the life of the contact)contacts:read-
GET/v1/contacts/{contact_id}/summarycontacts_summary: What a customer owes, has paid, ordered and booked, and what is nextcontacts:read-
POST/v1/contacts/{contact_id}/tagscontacts_add_tags: Add tags (by id or name; missing names are created)contacts:writeyes
DELETE/v1/contacts/{contact_id}/tags/{tag_id}contacts_remove_tag: Remove a tag from a contactcontacts:writeyes
GET/v1/contacts/{contact_id}/timelinecontacts_timeline: Activity timeline (notes, stage changes, consent, opt-outs, conversations, orders, payments, bookings, calls, automations)contacts:readyes
POST/v1/contacts/bulkcontacts_bulk_upsert: Bulk create/update contacts (up to 1,000)contacts:writeyes
POST/v1/contacts/bulk-deletecontacts_bulk_delete: Erase many contacts by ids or segment (second confirmation required)contacts:delete-
GET/v1/contacts/duplicatescontacts_find_duplicates: Duplicate candidates (same phone, same email, same name)contacts:read-
POST/v1/contacts/merge-previewcontacts_merge_preview: Preview a merge without changing anythingcontacts:read-

Request and response schemas: the interactive reference at https://api.wapitick.com/docs, or docs/api/openapi.json.

This page as Markdown