---
title: "Upload Document"
method: POST
path: "/number-registration/1/documents"
tags: ["platform", "numbers", "number-registration", "documents"]
---

# Upload Document

`POST /number-registration/1/documents`

## Request

- Base URL: `https://api.infobip.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.infobip.com/number-registration/1/documents`
- Auth: one of:
  - OAuth 2
    - Client credentials
    - Token URL: `https://api.infobip.com/auth/1/oauth2/token`
  - API key in header `Authorization`
  - API key in header `Authorization`
  - HTTP basic

Uploads a document file to the system and returns the document metadata. The uploaded document can be used for 10DLC campaign registration purposes. Documents not attached to a campaign within 7 days will be automatically deleted. Supported file types: .bmp, .dib, .docx, .gif, .htm, .html, .jpeg, .jpg, .m2a, .m4a, .m4b, .m4p, .m4r, .m4v, .mp1, .mp2, .mp3, .mp4, .mpa, .oga, .ogg, .ogm, .ogv, .ogx, .odt, .pdf, .png, .raw, .rtf, .spx, .tif, .tiff, .txt, .wav, .webm, .xml, Maximum file size: 10MB.

## Query parameters

- `applicationId` string
- `entityId` string

## Request body `multipart/form-data`

- 2700ea5ecfd0574f21019319e90eb63416ede8263eab67e466c718c51cd1a77aUploadDocumentApiDoc
  - `document` string, binary, required: The document file to be uploaded.
  - `applicationId` string: CPaaS X property identifying an application, a use case or an environment on your system. It should only be set if you are using CPaaS X Applications with your traffic.
  - `entityId` string: CPaaS X property identifying an unique actor on your system. Should only be set if you are using CPaaS X Applications with your traffic.

## Response `201`

Created

- 2700ea5ecfd0574f21019319e90eb63416ede8263eab67e466c718c51cd1a77aDocumentUploadMetadata
  - `documentId` string, uuid, required: Unique identifier for the document.
  - `documentName` string, required: Name of the document file.
  - `contentType` string, required: MIME type of the document content (e.g., application/pdf, image/png).
  - `contentLength` integer: Size of the document content in bytes.
  - `applicationId` string: CPaaS X property identifying an application, a use case or an environment on your system. It should only be set if you are using CPaaS X Applications with your traffic.
  - `entityId` string: CPaaS X property identifying an unique actor on your system. Should only be set if you are using CPaaS X Applications with your traffic.

## Other responses

- `400`: Bad Request
- `401`: Unauthorized
- `403`: Forbidden
- `500`: Internal Server Error

---

[API](https://skmtc.dev/infobip/apis/infobip-openapi-specification.md) - [All operations](https://skmtc.dev/infobip/apis/infobip-openapi-specification/llms.txt) - [OpenAPI document](https://skmtc.dev/infobip/apis/infobip-openapi-specification/revisions/9dcbbaf902de?raw)