Records

Create a contact

Creates a contact in the key's organization and fires the contact.added trigger. Duplicate emails are rejected with 400 VALIDATION_ERROR.

post/api/v1/contacts

Request

  • Base URL: https://api.agendaforge.app
  • URL: https://api.agendaforge.app/api/v1/contacts
  • 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

typestring

speaker | sponsor | attendee | vendor | partner | exhibitor | other. Defaults to "attendee".

firstNamestring required
lastNamestring required
emailstring email required
phonestring
companystring
jobTitlestring

Response

The created contact.

idstring
typestring

speaker | sponsor | attendee | vendor | partner | exhibitor | other.

firstNamestring
lastNamestring
emailstring
phonestring nullable
companystring nullable
jobTitlestring nullable
biostring nullable
avatarUrlstring nullable
locationstring nullable
websitestring nullable
socialLinksobject nullable

Map of platform to URL.

expertiseAreasstring[]
tagsstring[]
customFieldsobject nullable

Organization-defined custom fields.

sourcestring nullable
statusstring
ratingnumber nullable
createdAtstring

ISO-8601 UTC timestamp.

Changes

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