# Fairmarkit API settings

From the Fairmarkit API tab, you can generate an API key and configure the Fairmarkit webhooks. The Fairmarkit API is based on Open API Specification (OAS) based on REST. The Fairmarkit API has predictable resource-oriented URLs that use standard HTTP response codes, authentication, and verbs.

Important: The Fairmarkit API tab is a configuration setting that is not automatically enabled. If you are interested in using the Fairmarkit API or have any questions about settings specific to your enterprises, contact your Fairmarkit Customer Success Representative.

See also: For more information on the Fairmarkit API and webhooks, see [Fairmarkit API overview](/buyers/integrations/fairmarkit-api-overview.md) and the [Fairmarkit developer portal](https://developers.fairmarkit.com/).

### Access API settings <a href="#accessapisettings" id="accessapisettings"></a>

You can access Fairmarkit API settings from the Administration screen.

{% stepper %}
{% step %}
From the **menu**, select *Administration*.

{% endstep %}

{% step %}
Select the **Fairmarkit API settings** tab.
{% endstep %}
{% endstepper %}

### Manage your API key <a href="#manageyourapikey" id="manageyourapikey"></a>

The Fairmarkit API requires an API key to authenticate requests. You will need to include your key in every request made to the API. The API Key must be provided in the *X-FM-API-KEY* HTTP request header.

#### Generate an API Key

{% stepper %}
{% step %}
In **API Key**, click the **Generate** button.\
A key will generate and display in the field.
{% endstep %}

{% step %}
Click the **copy** button to copy the key to your clipboard.
{% endstep %}
{% endstepper %}

#### Generate a new API key

As needed, you can generate a new API key.

**Warning**: When you generate a new API key, you will deactivate any previously generated keys.

{% stepper %}
{% step %}
Click the **Generate** button.\
A message displays a warning that your previous key will be deactivated.
{% endstep %}

{% step %}
Click **Generate**.
{% endstep %}
{% endstepper %}

#### Deactivate an API key

You can deactivate an API key when it is no longer needed.

1. Click the **Deactivate** button.\
   A message displays a warning that any previous integrations will be lost.
2. Click **Deactivate**.

### Configure Fairmarkit webhooks <a href="#configurefairmarkitwebhooks" id="configurefairmarkitwebhooks"></a>

Fairmarkit webhooks allow you to get notifications from Fairmarkit about changes to your data as they are happening. Instead of having to pull 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 event is awarded, the RFQ\_AWARDED webhook can send updated event data to your application.

See also: For more information and sample code for the Fairmarkit webhooks, see the [Fairmarkit developer portal](https://developers.fairmarkit.com/docs/webhooks).

To create a webhook for your application, complete the following:

1. **In URL for Webhook**, enter the HTTP endpoint where your events will be sent. This can be up to 200 characters.
2. In **Authorization Token**, enter the authorization token. This field is optional unless an authorization is required to access the endpoint.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.fairmarkit.com/buyers/administration/fairmarkit-api-settings.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.