TextKitDocs

Create a customer

A business you send on behalf of.

POST/v1/customers

Body Parameters

  • namestring

    At most 200 characters. Nullable.

  • external_idstring

    Your id for them; unique per account At most 200 characters. Nullable.

  • metadataobject

    Up to 50 string values

Details

Assign numbers to it and its messages, verifications, events and usage carry its id. Optional; nothing requires customers.

Responses

  • 201Customer

    The customer

  • 400Error

    Invalid request

  • 401Error

    Missing, malformed, or revoked API key

  • 402Error

    Billable live calls only: the prepaid credit balance cannot cover the call (insufficient_credits); nothing was done or charged

  • 409Error

    external_id already used

  • 429Error

    Rate limit or quota exceeded

Response Fields

  • idstring

    Example: cus_a1B2c3D4e5F6g7.

  • objectcustomer
  • namestring

    Nullable.

  • external_idstring

    Nullable.

  • metadataobject
  • created_atstring (date-time)
  • updated_atstring (date-time)
  • phone_numbersarray of string

    Only on retrieve

Errors

Every error has the same JSON shape, and request_id matches the X-Request-Id response header. Errors lists every code and what to do about it.

  • 400

    Invalid request

  • 401

    Missing, malformed, or revoked API key

  • 402

    Billable live calls only: the prepaid credit balance cannot cover the call (insufficient_credits); nothing was done or charged

  • 409

    external_id already used

  • 429

    Rate limit or quota exceeded