Webhooks

Fairmarkit webhooks allow you to get notifications from Fairmarkit about changes to your data as they are happening. Instead of pulling information using the Fairmarkit API, the webhook will automatically push information to your endpoint as events happen. When the event happens, a one-way data share is automatically sent to your application. For example, when a request for quote (RFQ) event is awarded, the RFQ_AWARDED webhook can send updated RFQ data to your application.

For Buyer

Available Webhooks

The following webhook actions are available when the webhook URL is configured.

• RFQ_OPEN: Sends a notification when an RFQ is opened.
• RFQ_CLOSED: Sends a notification when an RFQ is closed.
• RFQ_AWARDED: Sends a notification when an RFQ is awarded.
• RFQ_ARCHIVED: Sends a notification when an RFQ is archived.
• RFQ_CANCELED: Sends a notification when an RFQ is canceled.
• SUPPLIER_CREATED: Sends a notification when a new supplier is created.
• BID_SUBMITTED: Sends a notification when a bid is submitted on an RFQ.

Create a webhook

To create a webhook for your application, complete the following

1. Log in to Fairmarkit as a Buyer - Admin (role).
2. Access the Fairmarkit API screen.
   (Administration / Fairmarkit API)

📘

If you don’t have access to the Fairmarkit API screen, contact Support.

3. In the Webhooks area, enter the following

• URL for Webhooks: Enter the HTTP endpoint where your events will be sent.
• Authorization token (optional): If authorization is required to access the endpoint, click Add authorization token and then enter the authorization token.

For Supplier

Available Webhooks

The following webhook actions are available when the webhook URL is configured:

• BID_CREATED: Sends a notification when an Buyer invite your to the Request;
• BID_AWARDED: Sends a notification when an Request was awarded by buyer;
• BID_LOST: Sends a notification when Buyer awarded response, but not yours;
• REQUEST_WITHDRAWN: Sends a notification when Buyer withdrawn Request;
• REQUEST_REOPEN: Sends a notification when Buyer reopen Request.

Create a webhook

To create a webhook for your application, complete the following

1. Log in to Fairmarkit as a Supplier - Admin (role).
2. Access the Fairmarkit API screen.
   (Administration / Fairmarkit API settings)

📘

If you don’t have access to the Fairmarkit API screen, contact Support.

3. In the Webhooks tab, enter the following

• URL for Webhooks: Enter the HTTP endpoint where your events will be sent;
• Authorization token: Token that was sent in HTTP header to access the endpoint;
• Authorization header: Title of authorization token header that was sent to access the endpoint.
• Notification Triggers: Select the triggers upon which you will receive notifications at the provided endpoint.