Skip to main content

Create an E911 address

POST 
/origination/e911_addresses

IMPORTANT: In order to use E911 services, Terms of Service must first be accepted through the Telnyx portal.

Creating an E911 Address requires the address fields to exactly match E911 Service records. All capital letters, and no punctuation is generally sufficient. For example, '123 Main St.' would be entered as '123 MAIN ST' in order to be valid. If there is not an exact match, a normalized address will be returned for your confirmation, and the status field will indicate so.

If the address submitted is invalid, then the endpoint will return an error and a corrected address. The endpoint must be called again with the corrected address.

NOTE: Enabling E911 for a number is done via PUT/origination/numbers/{id}/e911_settings

Request ​

Body

required

E911 Address to add

    first_name string

    Required if business name not given

    last_name string

    Required if business name not given

    business_name string

    Required if personal name not given

    line_1 stringrequired

    Address first line

    line_2 string

    Address second line

    city stringrequired
    state stringrequired
    postal_code stringrequired

Responses ​

200: E911 Address created response

Schema

    id stringrequired
    first_name stringrequired
    last_name stringrequired
    business_name stringrequired
    line_1 stringrequired
    line_2 stringrequired
    city stringrequired
    state stringrequired
    postal_code stringrequired
    status stringrequired

    Default value: success

400: Bad request

401: Unauthorized

Request samples

curl -L 'https://api.telnyx.com/origination/e911_addresses' \
-H 'Content-Type: application/json' \
-H 'Accept: application/json' \
-d '{
  "first_name": "John",
  "last_name": "Doe",
  "business_name": "MyCo, Inc",
  "line_1": "123 Main St",
  "line_2": "Apt 1",
  "city": "Chicago",
  "state": "IL",
  "postal_code": "60654"
}'

Response samples

{
  "id": "string",
  "first_name": "string",
  "last_name": "string",
  "business_name": "string",
  "line_1": "string",
  "line_2": "string",
  "city": "string",
  "state": "string",
  "postal_code": "string",
  "status": "success"
}