Records

Create up to 100 contacts in one request

Synchronous batch create. Each item behaves exactly like a single POST /api/v1/contacts request (same validation, same contact.added trigger). Items succeed or fail independently: the response pairs every input index with either the created contact or a typed error, so one duplicate email never fails the whole batch. For larger sets use POST /api/v1/imports/contacts.

post/api/v1/contacts/batch

Request

  • Base URL: https://api.agendaforge.app
  • URL: https://api.agendaforge.app/api/v1/contacts/batch
  • Auth: one of:
    • HTTP bearer
    • API key in header X-API-Key

Headers

Idempotency-Keystring

Optional key for safe retries, retained for 24 hours. Repeating the same request on the same endpoint returns the original response and sets Idempotent-Replay: true. Reusing the key on a different endpoint returns 409.

Request body

Response

Per-item results in input order plus a summary. HTTP 200 even when some items fail; inspect results[].status.

Changes

No recorded changes to this operation across all 1 revision of this API.