---
title: "Creates an Upload request"
method: POST
path: "/external_connections/{id}/uploads"
tags: ["External Connections"]
---

# Creates an Upload request

`POST /external_connections/{id}/uploads`

Creates a new Upload request to Microsoft teams with the included phone numbers. Only one of civic_address_id or location_id must be provided, not both. The maximum allowed phone numbers for the numbers_ids array is 1000.

## Path parameters

- `id` string, required

## Request body

- CreateExternalConnectionUploadRequest
  - `number_ids` string[], required
  - `usage` 'calling_user_assignment' | 'first_party_app_assignment' — The use case of the upload request. NOTE: `calling_user_assignment` is not supported for toll free numbers.
  - `additional_usages` string[]
  - `location_id` string, uuid — Identifies the location to assign all phone numbers to.
  - `civic_address_id` string, uuid — Identifies the civic address to assign all phone numbers to.

## Response `202`

Successful response

- object
  - `success` boolean — Describes wether or not the operation was successful
  - `ticket_id` string, uuid — Ticket id of the upload request

## Other responses

- `401` — Unauthorized
- `404` — Not found
- `413` — Payload too large. The maximum allowed phone numbers for the numbers_ids array is 1000.
- `422` — Unprocessable Entity
- `504` — Gateway Timeout

---

[API](https://skmtc.net/team-telnyx/apis/telnyx-api-2.md) · [All operations](https://skmtc.net/team-telnyx/apis/telnyx-api-2/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/team-telnyx/telnyx-api-2/versions/8f5f4e537994/schema)