> ## Documentation Index
> Fetch the complete documentation index at: https://docs.prelude.so/llms.txt
> Use this file to discover all available pages before exploring further.

# Submit a sender ID

> This endpoint allows you to submit a new sender ID for verification purposes.

In order to get access to this endpoint, contact our support team.


Submit a new custom sender ID for registration on your account. Prelude reviews each submission against carrier and regional regulations before approving it for use. Once approved, the sender ID becomes available to reference in the `options.sender_id` field of a [Create Verification](/verify/v2/api-reference/create-or-retry-a-verification) request.

<Info>
  Access to the management API is opt-in. [Contact our support team](mailto:support@prelude.so) to enable it on your account. Regional rules, fees, and registration timelines vary — see the [Custom Sender IDs](/verify/v2/documentation/sender-id) guide for details.
</Info>


## OpenAPI

````yaml post /v2/verification/management/sender-id
openapi: 3.1.0
info:
  title: Prelude API
  version: 2.0.0
  description: The Prelude API allows you to send messages to your users.
  contact:
    email: support@prelude.so
servers:
  - url: https://api.prelude.dev
    description: Production server
security:
  - apiToken: []
tags:
  - name: Notify
    description: Send transactional and marketing messages with compliance enforcement.
  - name: Transactional
    description: Send transactional messages (deprecated - use Notify API instead).
  - name: Verify
    description: Verify phone numbers.
  - name: Watch
    description: Evaluate email addresses and phone numbers for trustworthiness.
  - name: Lookup
    description: >-
      Retrieve detailed information about a phone number including carrier data,
      line type, and portability status.
paths:
  /v2/verification/management/sender-id:
    post:
      tags:
        - Verify
      summary: Submit a sender ID
      description: >
        This endpoint allows you to submit a new sender ID for verification
        purposes.


        In order to get access to this endpoint, contact our support team.
      operationId: submitSenderID
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/SubmitVerificationSenderIDRequest'
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/SubmitVerificationSenderIDResponse'
        '400':
          description: KO
          content:
            application/json:
              schema:
                oneOf:
                  - $ref: '#/components/schemas/SubmitVerificationSenderIDResponse'
                  - $ref: '#/components/schemas/Error'
components:
  schemas:
    SubmitVerificationSenderIDRequest:
      type: object
      required:
        - sender_id
      properties:
        sender_id:
          type: string
          description: The sender ID to add.
          examples:
            - Prelude
    SubmitVerificationSenderIDResponse:
      type: object
      required:
        - sender_id
        - status
      properties:
        sender_id:
          type: string
          description: The sender ID that was added.
        status:
          type: string
          description: |
            It indicates the status of the sender ID. Possible values are:
              * `approved` - The sender ID is approved.
              * `pending` - The sender ID is pending.
              * `rejected` - The sender ID is rejected.
          enum:
            - approved
            - pending
            - rejected
          examples:
            - approved
        reason:
          type: string
          description: The reason why the sender ID was rejected.
    Error:
      type: object
      properties:
        code:
          type: string
          description: The error code.
          examples:
            - invalid_phone_number
        message:
          type: string
          examples:
            - >-
              The provided phone number is invalid. Provide a valid E.164 phone
              number.
          description: A human-readable message describing the error.
        type:
          type: string
          examples:
            - bad_request
          description: The error type.
        request_id:
          type: string
          examples:
            - 3d19215e-2991-4a05-a41a-527314e6ff6a
          description: >-
            A string that identifies this specific request. Report it back to us
            to help us diagnose your issues.
      required:
        - code
        - message
        - type
  securitySchemes:
    apiToken:
      type: http
      scheme: bearer

````