Customers

Create a customer

Changed on

Creates a new customer record and automatically initiates identity, fraud, and risk assessment scores. This endpoint allows you to create a customer profile and associate it with paykeys and payments.

post/v1/customers

Request

  • Base URL
    https://sandbox.straddle.com
  • URL
    https://sandbox.straddle.com/v1/customers
  • Auth
    HTTP bearer

Headers

Straddle-Account-Idstring uuid

For use by platforms to specify an account id and set scope of a request.

Request-Idstring

Optional client generated identifier to trace and debug a request.

Correlation-Idstring

Optional client generated identifier to trace and debug a series of requests.

Idempotency-Keystring

Optional client generated value to use for idempotent requests.

Request body

namestring required

Full name of the individual or business name.

type'individual' | 'business' required
emailstring email required

The customer's email address.

phonestring required

The customer's phone number in E.164 format. Mobile number is preferred.

external_idstring nullable

Unique identifier for the customer in your database, used for cross-referencing between Straddle and your systems.

metadataobject nullable

Up to 20 additional user-defined key-value pairs. Useful for storing additional information about the customer in a structured format.

Example request

{
  "name": "Ron Swanson",
  "type": "individual",
  "email": "ron.swanson@pawnee.com",
  "address": {
    "address1": "123 Main St",
    "city": "Anytown",
    "state": "CA",
    "zip": "94105"
  },
  "phone": "+12128675309",
  "external_id": "customer_123",
  "device": {
    "ip_address": "192.168.1.1"
  },
  "metadata": {}
}

Response

Created

response_type'object' | 'array' | 'error' | 'none' required

Indicates the structure of the returned content.

  • "object" means the data field contains a single JSON object.
  • "array" means the data field contains an array of objects.
  • "error" means the data field contains an error object with details of the issue.
  • "none" means no data is returned.

Example response

{
  "data": {
    "name": "Ron Swanson",
    "email": "ron.swanson@pawnee.com",
    "phone": "+12128675309",
    "address": {
      "address1": "123 Main St",
      "address2": "Apt 1",
      "city": "Anytown",
      "state": "CA",
      "zip": "12345"
    },
    "compliance_profile": {
      "dob": "****-**-**",
      "ssn": "***-**-****"
    },
    "device": {
      "ip_address": "192.168.1.1"
    }
  }
}

Changes

  • 4c4191aab91dRevision changes
    • breaking

      removed the enum value Business of the request property (media type: application/json)

    • breaking

      removed the enum value Business of the request property (media type: text/json)

    • breaking

      removed the enum value Business of the request property (media type: application/*+json)

    • breaking

      removed the enum value Individual of the request property (media type: application/json)

    • breaking

      removed the enum value Individual of the request property (media type: text/json)

    • breaking

      removed the enum value Individual of the request property (media type: application/*+json)

    • info

      removed the Array enum value from the response property for the response status (media type: text/plain)

    • info

      removed the Array enum value from the response property for the response status (media type: application/json)

    • info

      removed the Array enum value from the response property for the response status (media type: text/json)

    • info

      removed the Array enum value from the response property for the response status (media type: text/plain)

    • info

      removed the Array enum value from the response property for the response status (media type: application/json)

    • info

      removed the Array enum value from the response property for the response status (media type: text/json)

    • info

      removed the Array enum value from the response property for the response status (media type: text/plain)

    • info

      removed the Array enum value from the response property for the response status (media type: application/json)

    • info

      removed the Array enum value from the response property for the response status (media type: text/json)

    • info

      removed the Array enum value from the response property for the response status (media type: text/plain)

    • info

      removed the Array enum value from the response property for the response status (media type: application/json)

    • info

      removed the Array enum value from the response property for the response status (media type: text/json)

    • info

      removed the Array enum value from the response property for the response status (media type: text/plain)

    • info

      removed the Array enum value from the response property for the response status (media type: application/json)

    • info

      removed the Array enum value from the response property for the response status (media type: text/json)

    • info

      removed the Array enum value from the response property for the response status (media type: text/plain)

    • info

      removed the Array enum value from the response property for the response status (media type: application/json)

    • info

      removed the Array enum value from the response property for the response status (media type: text/json)

    • info

      removed the Business enum value from the / response property for the response status (media type: text/plain)

    • info

      removed the Business enum value from the / response property for the response status (media type: application/json)

    • info

      removed the Business enum value from the / response property for the response status (media type: text/json)

    • info

      removed the Error enum value from the response property for the response status (media type: text/plain)

    • info

      removed the Error enum value from the response property for the response status (media type: application/json)

    • info

      removed the Error enum value from the response property for the response status (media type: text/json)

    • info

      removed the Error enum value from the response property for the response status (media type: text/plain)

    • info

      removed the Error enum value from the response property for the response status (media type: application/json)

    • info

      removed the Error enum value from the response property for the response status (media type: text/json)

    • info

      removed the Error enum value from the response property for the response status (media type: text/plain)

    • info

      removed the Error enum value from the response property for the response status (media type: application/json)

    • info

      removed the Error enum value from the response property for the response status (media type: text/json)

    • info

      removed the Error enum value from the response property for the response status (media type: text/plain)

    • info

      removed the Error enum value from the response property for the response status (media type: application/json)

    • info

      removed the Error enum value from the response property for the response status (media type: text/json)

    • info

      removed the Error enum value from the response property for the response status (media type: text/plain)

    • info

      removed the Error enum value from the response property for the response status (media type: application/json)

    • info

      removed the Error enum value from the response property for the response status (media type: text/json)

    • info

      removed the Error enum value from the response property for the response status (media type: text/plain)

    • info

      removed the Error enum value from the response property for the response status (media type: application/json)

    • info

      removed the Error enum value from the response property for the response status (media type: text/json)

    • info

      removed the Individual enum value from the / response property for the response status (media type: text/plain)

    • info

      removed the Individual enum value from the / response property for the response status (media type: application/json)

    • info

      removed the Individual enum value from the / response property for the response status (media type: text/json)

    • info

      removed the None enum value from the response property for the response status (media type: text/plain)

    • info

      removed the None enum value from the response property for the response status (media type: application/json)

    • info

      removed the None enum value from the response property for the response status (media type: text/json)

    • info

      removed the None enum value from the response property for the response status (media type: text/plain)

    • info

      removed the None enum value from the response property for the response status (media type: application/json)

    • info

      removed the None enum value from the response property for the response status (media type: text/json)

    • info

      removed the None enum value from the response property for the response status (media type: text/plain)

    • info

      removed the None enum value from the response property for the response status (media type: application/json)

    • info

      removed the None enum value from the response property for the response status (media type: text/json)

    • info

      removed the None enum value from the response property for the response status (media type: text/plain)

    • info

      removed the None enum value from the response property for the response status (media type: application/json)

    • info

      removed the None enum value from the response property for the response status (media type: text/json)

    • info

      removed the None enum value from the response property for the response status (media type: text/plain)

    • info

      removed the None enum value from the response property for the response status (media type: application/json)

    • info

      removed the None enum value from the response property for the response status (media type: text/json)

    • info

      removed the None enum value from the response property for the response status (media type: text/plain)

    • info

      removed the None enum value from the response property for the response status (media type: application/json)

    • info

      removed the None enum value from the response property for the response status (media type: text/json)

    • info

      removed the Object enum value from the response property for the response status (media type: text/plain)

    • info

      removed the Object enum value from the response property for the response status (media type: application/json)

    • info

      removed the Object enum value from the response property for the response status (media type: text/json)

    • info

      removed the Object enum value from the response property for the response status (media type: text/plain)

    • info

      removed the Object enum value from the response property for the response status (media type: application/json)

    • info

      removed the Object enum value from the response property for the response status (media type: text/json)

    • info

      removed the Object enum value from the response property for the response status (media type: text/plain)

    • info

      removed the Object enum value from the response property for the response status (media type: application/json)

    • info

      removed the Object enum value from the response property for the response status (media type: text/json)

    • info

      removed the Object enum value from the response property for the response status (media type: text/plain)

    • info

      removed the Object enum value from the response property for the response status (media type: application/json)

    • info

      removed the Object enum value from the response property for the response status (media type: text/json)

    • info

      removed the Object enum value from the response property for the response status (media type: text/plain)

    • info

      removed the Object enum value from the response property for the response status (media type: application/json)

    • info

      removed the Object enum value from the response property for the response status (media type: text/json)

    • info

      removed the Object enum value from the response property for the response status (media type: text/plain)

    • info

      removed the Object enum value from the response property for the response status (media type: application/json)

    • info

      removed the Object enum value from the response property for the response status (media type: text/json)

  • f9fe2a77d949Revision changes
    • warning

      added the new Array enum value to the response property for the response status (media type: text/plain)

    • warning

      added the new Array enum value to the response property for the response status (media type: application/json)

    • warning

      added the new Array enum value to the response property for the response status (media type: text/json)

    • warning

      added the new Array enum value to the response property for the response status (media type: text/plain)

    • warning

      added the new Array enum value to the response property for the response status (media type: application/json)

    • warning

      added the new Array enum value to the response property for the response status (media type: text/json)

    • warning

      added the new Array enum value to the response property for the response status (media type: text/plain)

    • warning

      added the new Array enum value to the response property for the response status (media type: application/json)

    • warning

      added the new Array enum value to the response property for the response status (media type: text/json)

    • warning

      added the new Array enum value to the response property for the response status (media type: text/plain)

    • warning

      added the new Array enum value to the response property for the response status (media type: application/json)

    • warning

      added the new Array enum value to the response property for the response status (media type: text/json)

    • warning

      added the new Array enum value to the response property for the response status (media type: text/plain)

    • warning

      added the new Array enum value to the response property for the response status (media type: application/json)

    • warning

      added the new Array enum value to the response property for the response status (media type: text/json)

    • warning

      added the new Array enum value to the response property for the response status (media type: text/plain)

    • warning

      added the new Array enum value to the response property for the response status (media type: application/json)

    • warning

      added the new Array enum value to the response property for the response status (media type: text/json)

    • warning

      added the new Business enum value to the / response property for the response status (media type: text/plain)

    • warning

      added the new Business enum value to the / response property for the response status (media type: application/json)

    • warning

      added the new Business enum value to the / response property for the response status (media type: text/json)

    • warning

      added the new Error enum value to the response property for the response status (media type: text/plain)

    • warning

      added the new Error enum value to the response property for the response status (media type: application/json)

    • warning

      added the new Error enum value to the response property for the response status (media type: text/json)

    • warning

      added the new Error enum value to the response property for the response status (media type: text/plain)

    • warning

      added the new Error enum value to the response property for the response status (media type: application/json)

    • warning

      added the new Error enum value to the response property for the response status (media type: text/json)

    • warning

      added the new Error enum value to the response property for the response status (media type: text/plain)

    • warning

      added the new Error enum value to the response property for the response status (media type: application/json)

    • warning

      added the new Error enum value to the response property for the response status (media type: text/json)

    • warning

      added the new Error enum value to the response property for the response status (media type: text/plain)

    • warning

      added the new Error enum value to the response property for the response status (media type: application/json)

    • warning

      added the new Error enum value to the response property for the response status (media type: text/json)

    • warning

      added the new Error enum value to the response property for the response status (media type: text/plain)

    • warning

      added the new Error enum value to the response property for the response status (media type: application/json)

    • warning

      added the new Error enum value to the response property for the response status (media type: text/json)

    • warning

      added the new Error enum value to the response property for the response status (media type: text/plain)

    • warning

      added the new Error enum value to the response property for the response status (media type: application/json)

    • warning

      added the new Error enum value to the response property for the response status (media type: text/json)

    • warning

      added the new Individual enum value to the / response property for the response status (media type: text/plain)

    • warning

      added the new Individual enum value to the / response property for the response status (media type: application/json)

    • warning

      added the new Individual enum value to the / response property for the response status (media type: text/json)

    • warning

      added the new None enum value to the response property for the response status (media type: text/plain)

    • warning

      added the new None enum value to the response property for the response status (media type: application/json)

    • warning

      added the new None enum value to the response property for the response status (media type: text/json)

    • warning

      added the new None enum value to the response property for the response status (media type: text/plain)

    • warning

      added the new None enum value to the response property for the response status (media type: application/json)

    • warning

      added the new None enum value to the response property for the response status (media type: text/json)

    • warning

      added the new None enum value to the response property for the response status (media type: text/plain)

    • warning

      added the new None enum value to the response property for the response status (media type: application/json)

    • warning

      added the new None enum value to the response property for the response status (media type: text/json)

    • warning

      added the new None enum value to the response property for the response status (media type: text/plain)

    • warning

      added the new None enum value to the response property for the response status (media type: application/json)

    • warning

      added the new None enum value to the response property for the response status (media type: text/json)

    • warning

      added the new None enum value to the response property for the response status (media type: text/plain)

    • warning

      added the new None enum value to the response property for the response status (media type: application/json)

    • warning

      added the new None enum value to the response property for the response status (media type: text/json)

    • warning

      added the new None enum value to the response property for the response status (media type: text/plain)

    • warning

      added the new None enum value to the response property for the response status (media type: application/json)

    • warning

      added the new None enum value to the response property for the response status (media type: text/json)

    • warning

      added the new Object enum value to the response property for the response status (media type: text/plain)

    • warning

      added the new Object enum value to the response property for the response status (media type: application/json)

    • warning

      added the new Object enum value to the response property for the response status (media type: text/json)

    • warning

      added the new Object enum value to the response property for the response status (media type: text/plain)

    • warning

      added the new Object enum value to the response property for the response status (media type: application/json)

    • warning

      added the new Object enum value to the response property for the response status (media type: text/json)

    • warning

      added the new Object enum value to the response property for the response status (media type: text/plain)

    • warning

      added the new Object enum value to the response property for the response status (media type: application/json)

    • warning

      added the new Object enum value to the response property for the response status (media type: text/json)

    • warning

      added the new Object enum value to the response property for the response status (media type: text/plain)

    • warning

      added the new Object enum value to the response property for the response status (media type: application/json)

    • warning

      added the new Object enum value to the response property for the response status (media type: text/json)

    • warning

      added the new Object enum value to the response property for the response status (media type: text/plain)

    • warning

      added the new Object enum value to the response property for the response status (media type: application/json)

    • warning

      added the new Object enum value to the response property for the response status (media type: text/json)

    • warning

      added the new Object enum value to the response property for the response status (media type: text/plain)

    • warning

      added the new Object enum value to the response property for the response status (media type: application/json)

    • warning

      added the new Object enum value to the response property for the response status (media type: text/json)

    • info

      added the new Business enum value to the request property (media type: application/json)

    • info

      added the new Business enum value to the request property (media type: text/json)

    • info

      added the new Business enum value to the request property (media type: application/*+json)

    • info

      added the new Individual enum value to the request property (media type: application/json)

    • info

      added the new Individual enum value to the request property (media type: text/json)

    • info

      added the new Individual enum value to the request property (media type: application/*+json)