Skip to main content
POST
/
v1
/
contacts
/
bulk-delete
cURL
curl -X POST https://api.migma.ai/v1/contacts/bulk-delete \
  -H "Authorization: Bearer $MIGMA_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: contacts-delete-batch-1" \
  -d '{
    "emails": ["john@example.com", "jane@example.com"],
    "projectId": "PROJECT_ID"
  }'
{
  "success": true,
  "data": {
    "deleted": 123,
    "notFound": [
      "<string>"
    ]
  },
  "error": "<string>"
}

Authorizations

Authorization
string
header
required

API key authentication. Use 'Authorization: Bearer YOUR_API_KEY' where YOUR_API_KEY is obtained from the Migma dashboard under Settings → API Integration.

Headers

Idempotency-Key
string

Optional key (max 100 chars) for safe retries. Same key + same body within 24h replays the original response (same status and body); same key + a different body returns 409 IDEMPOTENCY_CONFLICT. Scoped per API key.

Maximum string length: 100

Body

application/json
emails
string<email>[]
required

Email addresses to delete (1-1000 per request).

Required array length: 1 - 1000 elements
projectId
string
required

Response

Batch delete result

success
boolean
required
data
object
error
string | null