Contacts

Create or update a contact by email

Idempotent contact upsert keyed by email. Always answers 200 — the create-vs-update distinction is not signalled via status code.

Requires the contacts:write scope — Create, update, and delete your contacts.

post/api/contacts/upsert

Request

  • Base URL: https://api.sendly.now
  • URL: https://api.sendly.now/api/contacts/upsert
  • Auth: one of:
    • HTTP bearer
    • API key in cookie better-auth.session_token
    • OAuth 2 (authorization code, authorization URL https://app.sendly.now/api/auth/oauth2/authorize, token URL https://app.sendly.now/api/auth/oauth2/token, scopes: contacts:write)

Request body

customFieldsobject

Arbitrary JSON value (string, number, boolean, null, array, or object).

emailstring email required
subscribedboolean

Response

Contact created or updated

successtrue required

Changes

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