> ## Documentation Index > Fetch the complete documentation index at: https://docs.wavix.com/llms.txt > Use this file to discover all available pages before exploring further. # Create a Sender ID > Creates a Sender ID. Use the 10DLC API to create Sender IDs in the US. ## OpenAPI ````yaml https://wavix.github.io/wavix-openapi/wavix-api.yaml post /v3/messages/sender-ids openapi: 3.1.0 info: title: Wavix APIs description: >- Wavix provides robust APIs that let you integrate voice and text messaging features directly into your app. Send text, place calls, and access detailed reports programmatically. termsOfService: https://wavix.com/terms-and-conditions license: name: MIT identifier: MIT contact: name: Wavix url: https://wavix.com email: support@wavix.com version: '1.0' servers: - url: https://api.wavix.com description: https://api.wavix.com variables: {} security: - bearerAuth: [] tags: - name: SIP trunks description: SIP trunks - name: Buy description: Numbers - name: Cart description: Numbers - name: My numbers description: Numbers - name: Billing description: Billing, transactions, and invoices - name: Profile description: Account profile and customer information - name: CDRs description: Call detail records and call history - name: Speech Analytics description: Call transcription and speech analytics - name: SMS and MMS description: Messaging - name: Number Validator description: Phone number validation - name: Link shortener description: Short link and click metrics - name: 2FA description: Two-factor authentication - name: 10DLC description: 10DLC Campaigns and Brands - name: API Keys description: API key management - name: Call webhooks description: Webhook configuration for call events - name: Call control description: Programmable Voice - name: Call streaming description: Real-time call audio streaming over WebSocket - name: Call recording description: Call recording - name: Sub-accounts description: Sub-account management - name: Voice campaigns description: Outbound voice campaigns - name: Wavix Embeddable description: WebRTC embeddable widget paths: /v3/messages/sender-ids: post: tags: - SMS and MMS summary: Create a Sender ID description: Creates a Sender ID. Use the 10DLC API to create Sender IDs in the US. operationId: sms_and_mms_sender_ids_create parameters: [] requestBody: content: application/json: schema: $ref: '#/components/schemas/SenderIDCreateRequest' required: true responses: '201': description: Returns the created Sender ID. headers: {} content: application/json: schema: allOf: - $ref: '#/components/schemas/SenderIDDetails' examples: success: summary: Successful response value: id: 3c7a5a90-43e0-43e0-b006-fdfea30c5a7c sender_id: Wavix type: numeric allowlisted_in: - example usecase: example samples: - example '400': $ref: '#/components/responses/BadRequestErrorResponse' '403': $ref: '#/components/responses/ForbiddenErrorResponse' deprecated: false security: - bearerAuth: - messages:write components: schemas: SenderIDCreateRequest: title: SenderIDCreateRequest required: - sender_id - type - countries - usecase type: object additionalProperties: false properties: sender_id: type: string description: >- Sender ID name. Can be either an alphanumeric string or a phone number. example: Wavix type: $ref: '#/components/schemas/SenderIDType' countries: type: array items: type: string description: Two-letter ISO country codes where the Sender ID is allowlisted. usecase: type: string description: >- Primary use case for the Sender ID. One of `transactional` (account or order notifications), `promo` (marketing and promotional messages), or `authentication` (one-time passcodes and verification codes). enum: - transactional - promo - authentication example: transactional monthly_volume: type: string description: >- Expected number of messages sent per month from the Sender ID. One of `1-1000`, `1001-20000`, `20001-50000`, `50001-100000`, or `More than 100000`. Each value is the message-count band for the month. enum: - 1-1000 - 1001-20000 - 20001-50000 - 50001-100000 - More than 100000 example: 1001-20000 samples: type: array items: type: string description: Message samples. example: - Sample message 1 - Sample message 2 SenderIDDetails: title: SenderIDDetails required: - id - sender_id - type - allowlisted_in type: object additionalProperties: false properties: id: type: string description: Sender ID ID. example: 3c7a5a90-43e0-43e0-b006-fdfea30c5a7c sender_id: type: string description: Sender ID name. example: Wavix type: $ref: '#/components/schemas/SenderIDType' allowlisted_in: type: array items: type: string description: List of countries where the Sender ID is allowlisted. usecase: type: string description: >- Primary use case declared for the Sender ID, such as `transactional`, `promo`, or `authentication`. example: promo samples: type: array items: type: string description: Message samples. example: - Sample message 1 - Sample message 2 SenderIDType: title: SenderIDType enum: - numeric - alphanumeric type: string description: >- Format of the Sender ID. One of `numeric` (a phone number) or `alphanumeric` (a text sender name). ValidationErrorResponse: title: ValidationErrorResponse type: object properties: success: type: boolean description: >- Indicates whether the request was successful. Always `false` for this error. example: false message: type: string description: >- Human-readable description naming the missing or invalid request parameter. example: Missing or invalid parameter ForbiddenErrorResponse: title: ForbiddenErrorResponse type: object properties: success: type: boolean description: >- Indicates whether the request was successful. Always `false` for this error. example: false message: type: string description: Human-readable description of why access is forbidden. example: The service is not provisioned for your account. responses: BadRequestErrorResponse: description: Request failed. Missing or invalid parameter headers: {} content: application/json: schema: $ref: '#/components/schemas/ValidationErrorResponse' ForbiddenErrorResponse: description: Request failed. The feature is disabled for your account. headers: {} content: application/json: schema: $ref: '#/components/schemas/ForbiddenErrorResponse' securitySchemes: bearerAuth: type: http scheme: bearer description: > Wavix API key. Pass as `Authorization: Bearer `. Keys support per-resource scopes (none / read / write). See [Restricted keys and scopes](https://docs.wavix.com/api-reference/authentication#restricted-keys-and-scopes). ````