Skip to content
Seismic Orchestration

POST /customers/{id}/associated_persons

Add a new associated person to an existing business customer. Accepts the full AssociatedPerson shape.

Request

{
  "first_name": "Bob",
  "last_name": "Martinez",
  "email": "bob@example.com",
  "birth_date": "1985-07-14",
  "residential_address": {
    "street_line_1": "500 Market St",
    "city": "San Francisco",
    "subdivision": "US-CA",
    "postal_code": "94105",
    "country": "USA"
  },
  "has_ownership": true,
  "has_control": false,
  "is_signer": false,
  "ownership_percentage": 25
}

Response (201)

Same shape as GET /associated_persons/{id}. The parent customer's status may transition to under_review while the new person is verified.

Returns 422 invalid_customer_type if the parent customer is type: "individual".

curl -X POST "$BASE_URL/customers/cust_01HZ…/associated_persons" \
  -H "Api-Key: $SEISMIC_ORCHESTRATION_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "first_name": "Bob",
    "last_name": "Martinez",
    "email": "bob@example.com",
    "birth_date": "1985-07-14",
    "residential_address": {
      "street_line_1": "500 Market St",
      "city": "San Francisco",
      "subdivision": "US-CA",
      "postal_code": "94105",
      "country": "USA"
    },
    "has_ownership": true,
    "has_control": false,
    "is_signer": false,
    "ownership_percentage": 25
  }'