---
title: "Create Fax Routing Rule"
method: POST
path: "/v1/api/admin/fax-routing"
tags: ["Fax Routing Admin"]
---

# Create Fax Routing Rule

`POST /v1/api/admin/fax-routing`

Create a new fax number routing rule.

## Request body

- object
  - `faxNumber` string, required — E.164 format phone number (e.g., +12603285018) or wildcard (*)
  - `brandId` string, required — Employer.brandId or "*" for wildcard
  - `brandName` string, required — Display name for admin UI
  - `direction` 'incoming' | 'outgoing' | 'both', required
  - `isActive` boolean
  - `description` string

## Response `201`

Default Response

- object
  - `success` boolean, required
  - `routing` object, required
    - `_id` string, required
    - `faxNumber` string, required — E.164 format phone number (e.g., +12603285018) or wildcard (*)
    - `normalizedNumber` string, required — Digits only phone number including country code (e.g., 12603285018 from +12603285018), or "*" for wildcard fax number rules
    - `brandId` string, required — Employer.brandId or "*" for wildcard
    - `brandName` string, required — Display name for admin UI
    - `direction` 'incoming' | 'outgoing' | 'both', required
    - `isActive` boolean, required
    - `description` string, required
    - `createdAt` string, date-time, required
    - `updatedAt` string, date-time, required
    - `createdBy` string, required
    - `updatedBy` string, required
  - `message` string

## Other responses

- `400` — Default Response
- `401` — Default Response
- `403` — Default Response
- `409` — Default Response
- `500` — Default Response

---

[API](https://skmtc.net/bluehive-health/apis/bluehive-api.md) · [All operations](https://skmtc.net/bluehive-health/apis/bluehive-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/bluehive-health/bluehive-api/versions/e6e553c2594a/schema)