Skip to main content

​
Contacts operations span five workflow families.

Use these families together rather than as isolated endpoints:
  • Contacts CRUD
  • Contact imports
  • Contact exports
  • Contact segments
  • Compliance/DNC and erasure flows

​
Core CRUD and dedupe

curl "https://api.callaro.ai/api/v1/contacts?page=1&per_page=50&search=rahul" -H "X-Api-Key: $CALLARO_API_KEY"
curl -X POST "https://api.callaro.ai/api/v1/contacts" -H "X-Api-Key: $CALLARO_API_KEY" -H "Content-Type: application/json" -d '{"phone_e164":"+919900000001","first_name":"Rahul","email":"rahul@example.com","company":"Acme Realty"}'
curl "https://api.callaro.ai/api/v1/contacts/duplicates" -H "X-Api-Key: $CALLARO_API_KEY"
curl -X POST "https://api.callaro.ai/api/v1/contacts/501/merge" -H "X-Api-Key: $CALLARO_API_KEY" -H "Content-Type: application/json" -d '{"secondary_ids":[502,503]}'

​
Imports and exports

curl -X POST "https://api.callaro.ai/api/v1/contacts/import" -H "X-Api-Key: $CALLARO_API_KEY" -F "file=@contacts.csv" -F 'column_mapping={"Phone":"phone_e164","First Name":"first_name"}'
curl "https://api.callaro.ai/api/v1/contact-imports" -H "X-Api-Key: $CALLARO_API_KEY"
curl "https://api.callaro.ai/api/v1/contact-imports/77/error_report" -H "X-Api-Key: $CALLARO_API_KEY"
curl -X POST "https://api.callaro.ai/api/v1/contact-exports" -H "X-Api-Key: $CALLARO_API_KEY" -H "Content-Type: application/json" -d '{"filters":{"segment_id":19}}'
curl "https://api.callaro.ai/api/v1/contact-exports/44/download" -H "X-Api-Key: $CALLARO_API_KEY"

​
Segments and compliance

  • Segment APIs: GET/POST /api/v1/contact_segments, GET /api/v1/contact_segments/{id}/contacts
  • Contact data export: GET /api/v1/contacts/{id}/data_export
  • Erasure flows: DELETE /api/v1/contacts/{id}/gdpr_delete, DELETE /api/v1/contacts/{id}/hard_delete

​
Operator workflow checklist

  1. Validate CSV column mapping on a small test file.
  2. Review duplicate groups before merge.
  3. Assign contacts to segments used by campaign targeting.
  4. Validate DNC/compliance suppression before launch.
  5. Export sample contact set and verify downstream schema.
hard_delete is irreversible and should be restricted to controlled administrative workflows. Prefer logical delete or GDPR-specific flows where policy requires an audit trail.