Events

Record a contact event

Records a custom contact event. Identify the contact by exactly one ID, external ID, or email. A missing email or external ID creates a contact; an unknown contact ID returns 404. An organization-scoped idempotency key replays the original event. Event names use letters, digits, underscores, hyphens, and dots, up to 255 characters; contact. and samva. prefixes are reserved. Properties allow at most 50 keys and 32 KiB of UTF-8 JSON. Events are retained for 90 days.

post/v1/events

Request

  • Base URL: https://api.samva.dev
  • URL: https://api.samva.dev/v1/events
  • Auth: API key in header x-api-key

Request body

CreateEventPayload required(unresolved $ref)

Response

ContactEvent

idstring required
contactIdstring required
namestring required
source'api' | 'samva' required
propertiesJsonObject required
occurredAtstring required
recordedAtstring required

Changes

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