Read contacts in bulk
MepMail extension: returns up to 1000 contacts by id or by email address in one request, in request order, optionally with their properties and topic subscriptions. Entries that match no contact are listed under missing instead of failing the call. One call counts as one request against the rate limit.
Authorization
apiKey An API key from the dashboard (ms_…), sent as Authorization: Bearer. A sending-only key reaches the /emails routes only.
In: header
Request Body
application/json
TypeScript Definitions
Use the request body type in TypeScript.
Response Body
application/json
application/json
application/json
application/json
curl -X POST "https://example.com/contacts/batch/get" \ -H "Content-Type: application/json" \ -d '{ "contacts": [ { "email": "customer@example.com" }, { "id": "3f8a2c1e-5b7d-4e9f-a1c2-6d8e0f4b2a91" } ], "include": [ "topics" ] }'{ "object": "list", "data": [ { "id": "4ef9a417-02e9-4d39-ad75-9611e0fcc33c", "email": "customer@example.com", "first_name": "Ana", "last_name": "Silva", "created_at": "2026-10-19T12:00:00.000Z", "unsubscribed": false, "properties": {}, "topics": [ { "id": "faccb7a5-8a28-4e9a-ac64-8da1cc3bc1cb", "name": "Order updates", "description": "Shipping and delivery updates", "subscription": "opt_in", "explicit": false, "visibility": "public" } ], "object": "contact" } ], "missing": [ { "index": 1, "id": "4ef9a417-02e9-4d39-ad75-9611e0fcc33c", "email": "customer@example.com" } ]}Create contacts in bulk POST
MepMail extension: creates up to 1000 contacts in one request (Resend imports contacts only via CSV).
Delete contacts in bulk POST
MepMail extension (Resend deletes contacts one at a time): deletes up to 1000 contacts by id or by email address in one request and lists the rows actually deleted; unknown ids or addresses are ski…