# Fax

Welkin Health uses **Notifyre** as the fax vendor. The Fax connection is configured in the **Admin portal → Integrations → Fax**.

***

## Prerequisites

Before configuring Fax, make sure your organization's Fax feature is enabled. Contact your Welkin Implementation Manager or CSM to activate Fax for your environment.

***

## Admin Configuration

You will need three credentials from Notifyre: an API Token, a Signing Secret, and one or more System Fax Numbers.

### API Token

1. In Notifyre, go to the **Developer** section in the left-hand menu
2. Click the **API Tokens** tab → **+ New**
3. Enter a name and role; if necessary, specify an expiration date → **Save**
4. Copy the API token and paste it into the Admin Portal

> **Important:** The API token will only appear once. After you save it, it will be displayed as asterisks in the list and cannot be copied again.

### Signing Secret

1. In the same **Developer** section, go to the **Webhooks** tab → **+ New**
2. Enter the webhook URL in the following format:

   ```
   https://{apiUrl}/{tenantName}/{instanceName}/faxes/webhooks
   ```

   For example: `https://api.live.welkincloud.io/welkonnect/liza/faxes/webhooks`
3. Select the events: **Fax sent**, **Fax received**
4. Click **Save** — the webhook will appear in the table
5. In the **Signing Secret** column, click **Reveal**, then copy the value and paste it into the Admin Portal

### System Fax Numbers

1. In Notifyre, go to **Settings** in the left-hand menu → **Fax Numbers** tab
2. Click **+ Add New** to create a new number (you can also import an existing number)
3. Select the country and region → **Search** → select one of the available numbers
4. Add the number in the Admin Portal

You can add multiple fax numbers. When sending a fax from the Care Portal, users will be able to choose which number to use as the sender.


---

# 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.welkinhealth.com/admin/apis-and-integrations/fax.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.