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

# Connect a Phone Number

> Connect a phone number for artists on the In•Process protocol. After connection, a verification SMS message will be sent to the provided phone number.

**Overview:**

Artists can connect their phone number to enable SMS-based features and notifications.

1. An SMS verification message is automatically sent to the provided phone number.
   
   For example:
   
   > Someone is trying to connect this phone number to the artist profile for sweetman.eth on In•Process. If this was you, please reply 'yes'. If this was not you, please ignore this message.

2. If the artist replies "yes", the artist's phone number will be verified.
3. With a verified phone number the artist can create new Moments via SMS.



## OpenAPI

````yaml POST /phones
openapi: 3.1.0
info:
  title: In•Process API
  description: >-
    The In•Process API enables browsing and managing moments from timelines.
    Retrieve moments from a specific artist's timeline, browse the in•process
    collective timeline, or filter by collection. The API supports creating
    moments, managing collections, handling payments, and interacting with the
    In•Process protocol ecosystem.
  version: 1.0.0
servers:
  - url: https://api.inprocess.world/api
    description: Production server
security: []
paths:
  /phones:
    post:
      summary: Connect a Phone Number
      description: >-
        Connect a phone number for artists on the In•Process protocol. After
        connection, a verification SMS message will be sent to the provided
        phone number.


        **Overview:**


        Artists can connect their phone number to enable SMS-based features and
        notifications.


        1. An SMS verification message is automatically sent to the provided
        phone number.
           
           For example:
           
           > Someone is trying to connect this phone number to the artist profile for sweetman.eth on In•Process. If this was you, please reply 'yes'. If this was not you, please ignore this message.

        2. If the artist replies "yes", the artist's phone number will be
        verified.

        3. With a verified phone number the artist can create new Moments via
        SMS.
      operationId: connectPhone
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/ConnectPhoneRequest'
      responses:
        '200':
          description: Successful response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ConnectPhoneResponse'
              example:
                success: true
                message: Phone number connected and verification message sent
        '400':
          description: Validation error - Invalid request body or phone number format
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              example:
                message: Invalid request body
        '500':
          description: Server error - Failed to connect phone number or send SMS
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              example:
                message: Failed to connect phone number
      security:
        - apiKeyAuth: []
components:
  schemas:
    ConnectPhoneRequest:
      type: object
      required:
        - phone_number
      properties:
        phone_number:
          type: string
          description: Phone number in E.164 format (e.g., "+1234567890" or "+14155552671")
    ConnectPhoneResponse:
      type: object
      required:
        - success
        - message
      properties:
        success:
          type: boolean
          description: Indicates whether the operation was successful
        message:
          type: string
          description: A descriptive message about the operation result
    Error:
      type: object
      required:
        - status
        - message
      properties:
        status:
          type: string
          enum:
            - error
          description: Error status
        message:
          type: string
          description: Error message
        errors:
          type: array
          description: >-
            Optional array of field-level validation errors. Typically included
            in 400 Bad Request responses for validation errors.
          items:
            type: object
            required:
              - field
              - message
            properties:
              field:
                type: string
                description: The field name that failed validation
              message:
                type: string
                description: The validation error message for this field
  securitySchemes:
    apiKeyAuth:
      type: apiKey
      in: header
      name: x-api-key
      description: >-
        Artist API key for authentication. Get your API key from
        https://inprocess.world/manage/api-keys

````