Create a business entity

Creates a business entity

post/entities/businesses

Request body

external_entity_idstring

business_namestring

business_alternate_namestring

business_registry_idstring

business_federal_einstring

addressesobject[]

pii_status'successful' | 'failed' | 'pending'

Example request

{
  "external_entity_id": "087ac67e-17ab-4529-8d1a-a8b2214d305f",
  "business_name": "Alloy",
  "business_alternate_name": "DBA First Mile Group",
  "business_registry_id": "123456789",
  "business_federal_ein": "987654321",
  "addresses": [
    {
      "address_line_1": "41 E. 11th",
      "address_city": "New York",
      "address_state": "NY",
      "address_postal_code": "10003",
      "address_country_code": "US",
      "type": "business_primary"
    }
  ],
  "emails": [
    {
      "email_address": "safeandseamless@alloy.com"
    }
  ],
  "phones": [
    {
      "phone_number": "555-000-1234"
    }
  ],
  "pii_status": "successful"
}

Response

Entity

status_codestring

entity_tokenstring

external_entity_idstring

created_atnumber

business_namestring

business_alternate_namestring

business_registry_idstring

business_federal_einstring

addressesobject[]

entity_groupsItems[] — unresolved $ref

typestring

_linksLinks — unresolved $ref

Example response

{
  "entity_token": "B-aCF4FAkGKiTIZJFhproR",
  "external_entity_id": "087ac67e-17ab-4529-8d1a-a8b2214d305f",
  "created_at": 1652195922608,
  "business_name": "Alloy",
  "business_alternate_name": "DBA First Mile Group",
  "business_registry_id": "123456789",
  "business_federal_ein": "987654321",
  "addresses": [
    {
      "address_line_1": "41 E. 11th",
      "address_city": "New York",
      "address_state": "NY",
      "address_postal_code": "10003",
      "address_country_code": "US",
      "type": "business_primary"
    }
  ],
  "emails": [
    {
      "email_address": "safeandseamless@alloy.com"
    }
  ],
  "phones": [
    {
      "phone_number": "5550001234"
    }
  ],
  "entity_groups": [
    {
      "external_entity_group_ids": [
        "81999dc0-20de-4953-b0b2-2b2f5809c87d"
      ],
      "entity_group_token": "EG-nqnHfUO9NtkazKzVWVqR",
      "entity_group_name": "Jane's Biscuit Company",
      "entity_group_type": "business",
      "roles": [
        "primary"
      ],
      "ownership_percentage": null,
      "title": null,
      "entity_group_relationship_status": "successful",
      "relationship_created_at": "2025-12-16T14:53:10.538Z",
      "entity_group_created_at": "2025-12-16T14:53:10.538Z"
    }
  ],
  "_embedded": {},
  "_links": {
    "self": {
      "href": "/v1/entities/businesses/B-aCF4FAkGKiTIZJFhproR"
    }
  }
}

Changes

No recorded changes to this endpoint across all 1 revision of this API.