Fyno Documentation

Fire an Event

Notify multiple users

POST https://api.fyno.io/v1/{WSID}/{version}/event/bulk

This API enables you to notify multiple users with one event trigger.

Before firing your first notification event, you must perform the following actions in your Fyno account:

  • Create a Template
  • Create an Event
  • Create an API Key
  • And obtain your workspace ID from the API Keys page.

Authorization

Authorizationheaderstringrequired

Enter your API Key. If you don't have it already, you can create one from the API Keys page within your Fyno account

Path Parameters

WSIDpathstringrequired

Enter your workspace ID. You can obtain this value from the API Keys page within your Fyno account.

versionpathenum (string)required

Enter the version for which you wish to fire the notification.

Allowed valueslivetest

Body

batchbodyarray of objectrequired

Your batch payload must specify at least distinct_id or to while firing a notification event.

If the payload contains:

  • Option 1: ONLY to (and no distinct_id) - the event uses all destination values from the to object (as it is).

  • Option 2: ONLY distinct_id (and no to) - the event uses all destination values (such as SMS, WhatsApp, Email, Push, Voice and so on) from the user's profile and sends the notification.

  • Option 3: BOTH distinct_id and to - the to and distinct_id channel data merges (to object take precedences) and sends the notification. The sent notification is tagged to the ID specified, which can be then used to search the logs by using distinct_id.

eventbodystringrequired

Enter the name of the event you wish to fire.

Response

application/json

Request accepted successfully and it will be processed asynchronously.

eventstring
received_timenumber
request_idstring
responsearray of object