Sign in
Notifications

Send Notification

Queues a notification to every user of an experience or to an account's team, processed asynchronously. Every send is attributed to an app: use an app API key, or a credential acting on behalf of an app. Narrow the audience with user_ids to send a mention.

post/notifications

Headers

Idempotency-Keystring
Example:d9105228-4a08-46b1-8b91-42fed586d383

A unique key that makes this request safe to retry. See Idempotent requests.

Request body

account_idstring

Account whose team members receive the notification (biz_ tag). Exactly one of experience_id or account_id is required.

contentstring required

Main body text of the notification.

experience_idstring

Experience whose users receive the notification (exp_ tag). Exactly one of experience_id or account_id is required.

icon_user_idstring nullable

User whose profile picture is used as the notification icon. Defaults to the experience or account avatar.

rest_pathstring nullable

Path segment appended to the generated deep link that opens your app, for example /settings/billing.

subtitlestring nullable

Optional secondary line displayed below the title.

titlestring required

Headline text of the notification.

user_idsstring[]

Optional user_ tags narrowing the audience. When provided, only these users are notified (as a mention), provided they are in the targeted experience or account.

Example request

{
  "account_id": "biz_xxxxxxxxxxxxxx",
  "content": "Drop off at 4180 Burnet Rd. Plan on two days for the full coating.",
  "experience_id": "exp_xxxxxxxxxxxxxx",
  "icon_user_id": "user_xxxxxxxxxxxxxx",
  "rest_path": "/bookings/upcoming",
  "subtitle": "Tuesday 9:00 AM, Bay 2",
  "title": "Your ceramic coating is booked",
  "user_ids": [
    "user_xxxxxxxxxxxxxx"
  ]
}

Response

notification queued

successboolean required

Example response

{
  "success": true
}

Changes

Changed in 65 of the 74 revisions of this API.4682

  • 78e1ed7366cd1See the full diff
    • ○

      the security scope notification:create was removed from the endpoint's security scheme bearerAuth

      api-security-scope-removed

  • 73dd0533cd811See the full diff
    • ○

      the security scope notification:create was removed from the endpoint's security scheme bearerAuth

      api-security-scope-removed

  • 86b97292852d1See the full diff
    • ○

      the security scope notification:create was removed from the endpoint's security scheme bearerAuth

      api-security-scope-removed

  • c1dceb26e5051See the full diff
    • ○

      the security scope notification:create was removed from the endpoint's security scheme bearerAuth

      api-security-scope-removed

  • 7fcefabddb0a1See the full diff
    • ○

      the security scope notification:create was removed from the endpoint's security scheme bearerAuth

      api-security-scope-removed

    This revision also has 1 change that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog

  • 140d015b99661See the full diff
    • ○

      the security scope notification:create was removed from the endpoint's security scheme bearerAuth

      api-security-scope-removed

  • 35edb053220a1See the full diff
    • ○

      the security scope notification:create was removed from the endpoint's security scheme bearerAuth

      api-security-scope-removed

    This revision also has 2 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog

  • ac2b9b1c6a001See the full diff
    • ○

      the security scope notification:create was removed from the endpoint's security scheme bearerAuth

      api-security-scope-removed

  • a88353507eac1See the full diff
    • ○

      the security scope notification:create was removed from the endpoint's security scheme bearerAuth

      api-security-scope-removed

  • 51933d70d7f51See the full diff
    • ○

      the security scope notification:create was removed from the endpoint's security scheme bearerAuth

      api-security-scope-removed

Of the 74 revisions, 1 has no diff computed.