Custom Publishers

In addition to the existing default publishers, you can create new publishers with the product of your choice.

For custom publishers, you must add your own events. To ensure these events are received in Signals, provide the REST API URL of the custom events in the publisher application where the events will be posted. The API URL supports up to 500 requests per minute. If this threshold is exceeded, the REST API will be locked for the next 60 seconds.

Creating a Custom Publisher

To add a custom publisher:

1. Navigate to Publishers on the left menu and click the Add Publisher button.

2. Go to the Create Your Own Publisher section in the menubar and fill in the necessary details as shown here.

3. To add a custom event after providing the publisher details, click the Add button near the Events section.

4. Fill in the details of Events and click Create.

   The values for the API Name field should not contain any white spaces or hyphens and must not exceed 50 characters. It accepts underscores and alphanumeric values but cannot start with a numerical value.

5. Once you have created your event, click the Save button in the top-right corner.

Add Schema to Custom Events

Subscribed Events of a Custom Publisher are those with which you have created a rule. Non-Subscribed Events are the default events that have not yet been associated with any rule.

1. Select your desired custom publishers from the configured publishers list.

2. Click the more icon of a custom event from either Subscribed Events or Non-Subscribed Events. Select the Add Schema option.

3. A pop-up will appear with two methods to provide the event payload and generate schema.

Live

To capture an API call’s request payload and populate it here, select the Live Events option and copy the URL displayed here.

Provide this URL in the Publisher from which the API call is made.

In the GIF shown above, the live events URL is copied and provided to the publisher system. This URL listens to the publisher’s API calls for the next 15 minutes and displays them on this platform. You can select the required payload from the listened API calls and add its schema to the custom events.

Manual

You can also manually add the schema to the custom events. Select the Manual option and provide the request payload of the event.

The default keys of an event schema will be automatically populated on the right for the provided payload.

4. Click Save once you have generated the event schema.