---
title: "Add Fax Line User"
method: PUT
path: "/fax_line/add_user"
tags: ["Fax Line"]
---

# Add Fax Line User

`PUT /fax_line/add_user`

Grants a user access to the specified Fax Line.

## Request body

- FaxLineAddUserRequest
  - `number` string, required — The Fax Line number
  - `account_id` string — Account ID
  - `email_address` string, email — Email address

## Response `200`

successful operation

- FaxLineResponse
  - `fax_line` FaxLineResponseFaxLine, required
    - `number` string — Number
    - `created_at` integer — Created at
    - `updated_at` integer — Updated at
    - `accounts` AccountResponse[]
      - `account_id` string — The ID of the Account
      - `email_address` string — The email address associated with the Account.
      - `is_locked` boolean — Returns `true` if the user has been locked out of their account by a team admin.
      - `is_paid_hs` boolean — Returns `true` if the user has a paid Dropbox Sign account.
      - `is_paid_hf` boolean — Returns `true` if the user has a paid HelloFax account.
      - `quotas` AccountResponseQuotas — Details concerning remaining monthly quotas.
        - `api_signature_requests_left` integer, nullable — API signature requests remaining.
        - `documents_left` integer, nullable — Signature requests remaining.
        - `templates_total` integer, nullable — Total API templates allowed.
        - `templates_left` integer, nullable — API templates remaining.
        - `sms_verifications_left` integer, nullable — SMS verifications remaining.
        - `num_fax_pages_left` integer, nullable — Number of fax pages left
      - `callback_url` string, nullable — The URL that Dropbox Sign events will `POST` to.
      - `role_code` string, nullable — The membership role for the team.
      - `team_id` string, nullable — The id of the team account belongs to.
      - `locale` string, nullable — The locale used in this Account. Check out the list of [supported locales](/api/reference/constants/#supported-locales) to learn more about the possible values.
      - `usage` AccountResponseUsage — Details concerning monthly usage
        - `fax_pages_sent` integer, nullable — Number of fax pages sent
      - `settings` AccountResponseSettings — Subset of configured settings
        - `signer_access_codes` boolean — Returns `true` if _Custom access codes_ is enabled in Admin Console. [Read more](https://developers.hellosign.com/docs/sms-tools/walkthrough).
        - `sms_delivery` boolean — Returns `true` if _Text message_ is enabled in Admin Console. [Read more](https://developers.hellosign.com/docs/sms-tools/walkthrough).
        - `sms_authentication` boolean — Returns `true` if _Signer authentication_ is enabled in Admin Console. [Read more](https://developers.hellosign.com/docs/sms-tools/walkthrough).
  - `warnings` WarningResponse — A list of warnings.
    - `warning_msg` string, required — Warning message
    - `warning_name` string, required — Warning name

## Other responses

- `4XX` — failed_operation

## Changes

- **2025-08-15** `2024a8a2efbd` — 1 info
  - added the optional property `fax_line/accounts/items/settings` to the response with the `200` status
- **2024-10-29** `6b55214d405f` — 1 breaking, 1 info
  - the response property `fax_line/accounts/items/usage/fax_pages_sent` became nullable for the status `200`
  - the `fax_pages_sent` response's property default value `0` was removed for the status `200`
- **2024-10-29** `8a9d24842043` — 6 info
  - the `api_signature_requests_left` response's property default value `0` was removed for the status `200`
  - the `documents_left` response's property default value `0` was removed for the status `200`
  - the `num_fax_pages_left` response's property default value `0` was removed for the status `200`
  - the `sms_verifications_left` response's property default value `0` was removed for the status `200`
  - …2 more
- **2024-10-21** `57b6afa6c2f0` — 7 info
  - the `api_signature_requests_left` response's property default value `0` was added for the status `200`
  - the `documents_left` response's property default value `0` was added for the status `200`
  - the `fax_pages_sent` response's property default value `0` was added for the status `200`
  - the `num_fax_pages_left` response's property default value `0` was added for the status `200`
  - …3 more
- …earlier changes not shown

[Full history](https://skmtc.dev/hellosign/apis/dropbox-sign-api/changes/fax_line/add_user/put.md)

---

[API](https://skmtc.dev/hellosign/apis/dropbox-sign-api.md) · [All operations](https://skmtc.dev/hellosign/apis/dropbox-sign-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/hellosign/dropbox-sign-api/revisions/2998c4df4efd/schema)