v52

OpenAPI 3.1.0raw.githubusercontent.com2026-07-311,1941,9384.1 MB
External Connections

Creates an Upload request

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.

post/external_connections/{id}/uploads

Path parameters

idstring required
Example:1293384261075731499

Identifies the resource.

Request body

additional_usagesstring[]
civic_address_idstring uuid

Identifies the civic address to assign all phone numbers to.

location_idstring uuid

Identifies the location to assign all phone numbers to.

number_idsstring[] 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.

Example request

{
  "location_id": "67ea7693-9cd5-4a68-8c76-abb3aa5bf5d2",
  "number_ids": [
    "3920457616934164700",
    "3920457616934164701",
    "3920457616934164702",
    "3920457616934164703"
  ],
  "usage": "first_party_app_assignment"
}

Response

Successful response

successboolean

Describes wether or not the operation was successful

ticket_idstring uuid

Ticket id of the upload request