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

# Create Subscriber

> Create a WhatsApp subscriber/contact via the ChatSyncs API without waiting for them to message your bot first — request parameters, GET and POST examples, and the response shapes for success, duplicate, and account-not-found cases. Use when a developer asks how to add a contact programmatically or bulk-import subscribers from their own system.

Creates a subscriber (contact) on a connected WhatsApp number, without requiring them to
message your bot first — useful for importing existing contacts from a CRM or signup form.


## OpenAPI

````yaml POST /whatsapp/subscriber/create
openapi: 3.1.0
info:
  title: ChatSyncs Developer API
  version: 1.0.0
  description: >-
    REST API for sending WhatsApp messages and managing subscribers through
    ChatSyncs.
servers:
  - url: https://platform.chatsyncs.com/api/v1
security: []
paths:
  /whatsapp/subscriber/create:
    post:
      tags:
        - Subscriber API
      summary: Create Subscriber
      operationId: createSubscriber
      requestBody:
        required: true
        content:
          application/x-www-form-urlencoded:
            schema:
              type: object
              properties:
                apiToken:
                  type: string
                  description: >-
                    Your ChatSyncs API key (not a WhatsApp/Meta access token).
                    [Where to find
                    it](/developer-api/finding-ids#api-token-apitoken).
                  example: API-KEY
                phoneNumberID:
                  type: string
                  description: >-
                    The WhatsApp account's phone number ID to create this
                    subscriber under. (Note: camelCase.) [Where to find
                    it](/developer-api/finding-ids#phone-number-id-phone_number_id).
                  example: PHONE-NUMBER-ID
                name:
                  type: string
                  description: The subscriber's name.
                  example: NAME
                phoneNumber:
                  type: string
                  description: >-
                    The subscriber's number, with country code and no + sign,
                    digits only. (Note: camelCase.)
                  example: MOBILE
              required:
                - apiToken
                - phoneNumberID
                - name
                - phoneNumber
      responses:
        '200':
          description: >-
            Standard ChatSyncs response. `status` is `"1"` on success and `"0"`
            on failure.
          content:
            application/json:
              schema:
                type: object
                properties:
                  status:
                    type: string
                    description: '`"1"` = success, `"0"` = failure.'
                  message:
                    type: string
                    description: Human-readable result message.
              examples:
                success:
                  summary: Success
                  value:
                    status: '1'
                    message: Subscriber created successfully.
                error:
                  summary: Error
                  value:
                    status: '0'
                    message: Invalid request.

````