---
title: "Submit a DIR's references"
method: POST
path: "/dir/{dir_id}/references"
tags: ["DIR References"]
---

# Submit a DIR's references

`POST /dir/{dir_id}/references`

Submit the two business references and one financial reference for a DIR.

The DIR's authorizer email must be verified first (see the email-verification endpoint). Until it is, this returns `409` and no references are stored.

The request body carries exactly two business references plus one financial reference. On success the references are stored and the response echoes them in the same shape as the GET. Submitting again converges on the already-stored references rather than erroring.

## Path parameters

- `dir_id` string, uuid, required

## Request body

- ReferenceSubmissionRequest — Exactly two business references plus one financial reference. The DIR's authorizer email must be verified before this is accepted.
  - `business_references` ReferenceInput[], required — Exactly two business references.
    - `email` string, email, required — Reference contact email address. Required: the reference is emailed scheduling and dial-in notices.
    - `full_name` string, required — Full name of the reference contact.
    - `job_title` string, nullable — Job title of the reference contact.
    - `organization` string, nullable — Organization the reference contact belongs to.
    - `phone_e164` string, required — Reference phone number in E.164 format, e.g. +14155550123.
    - `relationship_to_registrant` string, nullable — How the reference contact is related to the registering business.
    - `timezone` string, required — IANA timezone id for the reference (e.g. America/New_York). Required: calls are only placed within the reference's local 8am-9pm window.
  - `financial_reference` ReferenceInput, required — One reference supplied at submit. The reference type is implied by the field that carries it (business_references vs financial_reference).
    - `email` string, email, required — Reference contact email address. Required: the reference is emailed scheduling and dial-in notices.
    - `full_name` string, required — Full name of the reference contact.
    - `job_title` string, nullable — Job title of the reference contact.
    - `organization` string, nullable — Organization the reference contact belongs to.
    - `phone_e164` string, required — Reference phone number in E.164 format, e.g. +14155550123.
    - `relationship_to_registrant` string, nullable — How the reference contact is related to the registering business.
    - `timezone` string, required — IANA timezone id for the reference (e.g. America/New_York). Required: calls are only placed within the reference's local 8am-9pm window.

## Response `201`

The stored references.

- ReferenceList
  - `data` Reference[], required
    - `email` string, email, nullable — Reference contact email address.
    - `full_name` string, required — Full name of the reference contact.
    - `job_title` string, nullable — Job title of the reference contact.
    - `organization` string, nullable — Organization the reference contact belongs to.
    - `phone_e164` string, required — Reference phone number in E.164 format.
    - `record_type` 'dir_reference', required — Always `dir_reference`.
    - `ref_type` 'business' | 'financial', required — Whether this is a business reference or the financial reference.
    - `relationship_to_registrant` string, nullable — How the reference contact is related to the registering business.
    - `slot` integer, required — Position within the reference type. Business references occupy slots 0 and 1; the financial reference occupies slot 0.
    - `timezone` string, required — IANA timezone id for the reference. Calls are only placed within the reference's local 8am-9pm window.

## Other responses

- `404` — An error occurred. The response carries the standard Telnyx error envelope.
- `409` — An error occurred. The response carries the standard Telnyx error envelope.

---

[API](https://skmtc.dev/team-telnyx/apis/telnyx-api-2.md) · [All operations](https://skmtc.dev/team-telnyx/apis/telnyx-api-2/llms.txt) · [OpenAPI document](https://skmtc.dev/team-telnyx/apis/telnyx-api-2/revisions/2dfcaa51b752?raw)