Customers

Update a customer

Changed on

Updates an existing customer's information. This endpoint allows you to modify the customer's contact details, PII, and metadata.

put/v1/customers/{id}

Request

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

Path parameters

idstring uuid required

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

The customer's full name or business name.

emailstring email required

The customer's email address.

phonestring required

The customer's phone number in E.164 format.

external_idstring nullable

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

status'pending' | 'review' | 'verified' | 'inactive' | 'rejected' required
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

{
  "address": {
    "address1": "123 Main St",
    "address2": "Apt 1",
    "city": "Anytown",
    "state": "CA",
    "zip": "12345"
  },
  "compliance_profile": {
    "ssn": "123-45-6789",
    "dob": "1969-04-20"
  },
  "device": {
    "ip_address": "192.168.1.1"
  }
}

Response

OK

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
    • 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)