Telnyx API — Whatsapp Phone Numbers

naftiko: 1.0.0-alpha2
info:
  label: Telnyx API — Whatsapp Phone Numbers
  description: 'Telnyx API — Whatsapp Phone Numbers. 12 operations. Lead operation: Initialize Whatsapp phone number verification.
    Self-contained Naftiko capability covering one Telnyx business surface.'
  tags:
  - Telnyx
  - Whatsapp Phone Numbers
  created: '2026-05-19'
  modified: '2026-05-19'
binds:
- namespace: env
  keys:
    TELNYX_API_KEY: TELNYX_API_KEY
capability:
  consumes:
  - type: http
    namespace: telnyx-whatsapp-phone-numbers
    baseUri: https://api.telnyx.com/v2
    description: Telnyx API — Whatsapp Phone Numbers business capability. Self-contained, no shared references.
    resources:
    - name: v2-whatsapp-business_accounts-id-phone_numbers
      path: /v2/whatsapp/business_accounts/{id}/phone_numbers
      operations:
      - name: initializewhatsappverification
        method: POST
        description: Initialize Whatsapp phone number verification
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    - name: v2-whatsapp-phone_numbers
      path: /v2/whatsapp/phone_numbers
      operations:
      - name: listphonenumbers
        method: GET
        description: List Whatsapp phone numbers
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: v2-whatsapp-phone_numbers-phone_number
      path: /v2/whatsapp/phone_numbers/{phone_number}
      operations:
      - name: deletewhatsappphonenumber
        method: DELETE
        description: Delete a Whatsapp phone number
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: v2-whatsapp-phone_numbers-phone_number-calling_settings
      path: /v2/whatsapp/phone_numbers/{phone_number}/calling_settings
      operations:
      - name: getwhatsappcallingsettings
        method: GET
        description: Get calling settings for a phone number
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
      - name: patchwhatsappcallingsettings
        method: PATCH
        description: Enable or disable Whatsapp calling for a phone number
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    - name: v2-whatsapp-phone_numbers-phone_number-profile
      path: /v2/whatsapp/phone_numbers/{phone_number}/profile
      operations:
      - name: getwhatsappprofile
        method: GET
        description: Get phone number business profile
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
      - name: patchwhatsappprofile
        method: PATCH
        description: Update phone number business profile
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    - name: v2-whatsapp-phone_numbers-phone_number-profile-photo
      path: /v2/whatsapp/phone_numbers/{phone_number}/profile/photo
      operations:
      - name: deletewhatsappprofilephoto
        method: DELETE
        description: Delete Whatsapp profile photo
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
      - name: getwhatsappprofilephoto
        method: GET
        description: Get Whatsapp profile photo
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
      - name: postwhatsappprofilephoto
        method: POST
        description: Upload Whatsapp profile photo
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    - name: v2-whatsapp-phone_numbers-phone_number-resend_verification
      path: /v2/whatsapp/phone_numbers/{phone_number}/resend_verification
      operations:
      - name: resendwhatsappverification
        method: POST
        description: Resend verification code
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    - name: v2-whatsapp-phone_numbers-phone_number-verify
      path: /v2/whatsapp/phone_numbers/{phone_number}/verify
      operations:
      - name: verifywhatsappphonenumber
        method: POST
        description: Submit verification code for a phone number
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    authentication:
      type: bearer
      token: '{{env.TELNYX_API_KEY}}'
  exposes:
  - type: rest
    namespace: telnyx-whatsapp-phone-numbers-rest
    port: 8080
    description: REST adapter for Telnyx API — Whatsapp Phone Numbers. One Spectral-compliant resource per consumed operation,
      prefixed with /v1.
    resources:
    - path: /v1/v2/whatsapp/business-accounts/{id}/phone-numbers
      name: v2-whatsapp-business-accounts-id-phone-numbers
      description: REST surface for v2-whatsapp-business_accounts-id-phone_numbers.
      operations:
      - method: POST
        name: initializewhatsappverification
        description: Initialize Whatsapp phone number verification
        call: telnyx-whatsapp-phone-numbers.initializewhatsappverification
        with:
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/v2/whatsapp/phone-numbers
      name: v2-whatsapp-phone-numbers
      description: REST surface for v2-whatsapp-phone_numbers.
      operations:
      - method: GET
        name: listphonenumbers
        description: List Whatsapp phone numbers
        call: telnyx-whatsapp-phone-numbers.listphonenumbers
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/v2/whatsapp/phone-numbers/{phone-number}
      name: v2-whatsapp-phone-numbers-phone-number
      description: REST surface for v2-whatsapp-phone_numbers-phone_number.
      operations:
      - method: DELETE
        name: deletewhatsappphonenumber
        description: Delete a Whatsapp phone number
        call: telnyx-whatsapp-phone-numbers.deletewhatsappphonenumber
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/v2/whatsapp/phone-numbers/{phone-number}/calling-settings
      name: v2-whatsapp-phone-numbers-phone-number-calling-settings
      description: REST surface for v2-whatsapp-phone_numbers-phone_number-calling_settings.
      operations:
      - method: GET
        name: getwhatsappcallingsettings
        description: Get calling settings for a phone number
        call: telnyx-whatsapp-phone-numbers.getwhatsappcallingsettings
        outputParameters:
        - type: object
          mapping: $.
      - method: PATCH
        name: patchwhatsappcallingsettings
        description: Enable or disable Whatsapp calling for a phone number
        call: telnyx-whatsapp-phone-numbers.patchwhatsappcallingsettings
        with:
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/v2/whatsapp/phone-numbers/{phone-number}/profile
      name: v2-whatsapp-phone-numbers-phone-number-profile
      description: REST surface for v2-whatsapp-phone_numbers-phone_number-profile.
      operations:
      - method: GET
        name: getwhatsappprofile
        description: Get phone number business profile
        call: telnyx-whatsapp-phone-numbers.getwhatsappprofile
        outputParameters:
        - type: object
          mapping: $.
      - method: PATCH
        name: patchwhatsappprofile
        description: Update phone number business profile
        call: telnyx-whatsapp-phone-numbers.patchwhatsappprofile
        with:
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/v2/whatsapp/phone-numbers/{phone-number}/profile/photo
      name: v2-whatsapp-phone-numbers-phone-number-profile-photo
      description: REST surface for v2-whatsapp-phone_numbers-phone_number-profile-photo.
      operations:
      - method: DELETE
        name: deletewhatsappprofilephoto
        description: Delete Whatsapp profile photo
        call: telnyx-whatsapp-phone-numbers.deletewhatsappprofilephoto
        outputParameters:
        - type: object
          mapping: $.
      - method: GET
        name: getwhatsappprofilephoto
        description: Get Whatsapp profile photo
        call: telnyx-whatsapp-phone-numbers.getwhatsappprofilephoto
        outputParameters:
        - type: object
          mapping: $.
      - method: POST
        name: postwhatsappprofilephoto
        description: Upload Whatsapp profile photo
        call: telnyx-whatsapp-phone-numbers.postwhatsappprofilephoto
        with:
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/v2/whatsapp/phone-numbers/{phone-number}/resend-verification
      name: v2-whatsapp-phone-numbers-phone-number-resend-verification
      description: REST surface for v2-whatsapp-phone_numbers-phone_number-resend_verification.
      operations:
      - method: POST
        name: resendwhatsappverification
        description: Resend verification code
        call: telnyx-whatsapp-phone-numbers.resendwhatsappverification
        with:
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/v2/whatsapp/phone-numbers/{phone-number}/verify
      name: v2-whatsapp-phone-numbers-phone-number-verify
      description: REST surface for v2-whatsapp-phone_numbers-phone_number-verify.
      operations:
      - method: POST
        name: verifywhatsappphonenumber
        description: Submit verification code for a phone number
        call: telnyx-whatsapp-phone-numbers.verifywhatsappphonenumber
        with:
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
  - type: mcp
    namespace: telnyx-whatsapp-phone-numbers-mcp
    port: 9090
    transport: http
    description: MCP adapter for Telnyx API — Whatsapp Phone Numbers. One tool per consumed operation, routed inline through
      this capability's consumes block.
    tools:
    - name: initialize-whatsapp-phone-number-verification
      description: Initialize Whatsapp phone number verification
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: telnyx-whatsapp-phone-numbers.initializewhatsappverification
      with:
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: list-whatsapp-phone-numbers
      description: List Whatsapp phone numbers
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: telnyx-whatsapp-phone-numbers.listphonenumbers
      outputParameters:
      - type: object
        mapping: $.
    - name: delete-whatsapp-phone-number
      description: Delete a Whatsapp phone number
      hints:
        readOnly: false
        destructive: true
        idempotent: true
      call: telnyx-whatsapp-phone-numbers.deletewhatsappphonenumber
      outputParameters:
      - type: object
        mapping: $.
    - name: get-calling-settings-phone-number
      description: Get calling settings for a phone number
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: telnyx-whatsapp-phone-numbers.getwhatsappcallingsettings
      outputParameters:
      - type: object
        mapping: $.
    - name: enable-disable-whatsapp-calling-phone
      description: Enable or disable Whatsapp calling for a phone number
      hints:
        readOnly: false
        destructive: false
        idempotent: true
      call: telnyx-whatsapp-phone-numbers.patchwhatsappcallingsettings
      with:
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: get-phone-number-business-profile
      description: Get phone number business profile
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: telnyx-whatsapp-phone-numbers.getwhatsappprofile
      outputParameters:
      - type: object
        mapping: $.
    - name: update-phone-number-business-profile
      description: Update phone number business profile
      hints:
        readOnly: false
        destructive: false
        idempotent: true
      call: telnyx-whatsapp-phone-numbers.patchwhatsappprofile
      with:
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: delete-whatsapp-profile-photo
      description: Delete Whatsapp profile photo
      hints:
        readOnly: false
        destructive: true
        idempotent: true
      call: telnyx-whatsapp-phone-numbers.deletewhatsappprofilephoto
      outputParameters:
      - type: object
        mapping: $.
    - name: get-whatsapp-profile-photo
      description: Get Whatsapp profile photo
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: telnyx-whatsapp-phone-numbers.getwhatsappprofilephoto
      outputParameters:
      - type: object
        mapping: $.
    - name: upload-whatsapp-profile-photo
      description: Upload Whatsapp profile photo
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: telnyx-whatsapp-phone-numbers.postwhatsappprofilephoto
      with:
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: resend-verification-code
      description: Resend verification code
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: telnyx-whatsapp-phone-numbers.resendwhatsappverification
      with:
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: submit-verification-code-phone-number
      description: Submit verification code for a phone number
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: telnyx-whatsapp-phone-numbers.verifywhatsappphonenumber
      with:
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.