> ## Documentation Index
> Fetch the complete documentation index at: https://developer.alloy.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Business Created

A business Entity along with their PII has been created

## Example Use Case

A business has been created in your system and you do not want to run KYB on it at the present time.

## Request Specifications

<Table align={["left","left","left"]}>
  <thead>
    <tr>
      <th>
        Required API Field
      </th>

      <th>
        Definition
      </th>

      <th>
        Notes
      </th>
    </tr>
  </thead>

  <tbody>
    <tr>
      <td>
        `timestamp`
      </td>

      <td>
        Timestamp of the event.
      </td>

      <td />
    </tr>

    <tr>
      <td>
        One of:\
        `external_entity_id`\
        `entity_token`
      </td>

      <td>
        Unique identifier for the Entity.
      </td>

      <td>
        The `external_entity_id` field is immutable and cannot be changed to a different value if one is already set. The value you supply in this field should be the best identifier to uniquely the Person/Business entity at your financial institution.
      </td>
    </tr>
  </tbody>
</Table>

### Example Request/Response

```json Request
{
    "event_type": "business_created",
    "event_status": "successful",
    "event_lifecycle_id": "X12-43jf-8432favmjjja",
    "data": {
        "external_entity_id": "e3065d04-95aa-47a1-915c-84b575ff3855",
        "business_name": "Operative Inc.",
        "timestamp": "2024-03-25T22:06:56.771Z",
        "business_federal_ein": "586179405",
        "emails": [{
            "email_address": "example@alloy.com"
        }],
        "addresses": [
            {
                "line_1": "123 Allen St",
                "line_2": "Suite 1",
                "city": "New York",
                "state": "NY",
                "postal_code": "10002",
                "country_code": "US",
                "type": "business_primary"
            }
        ],
        "supplemental_data": {},
        "meta": {}
    }
}
```

```json Response
{
    "status_code": 201,
    "event_request_token": "EV-YtbNK8AxWHJbMukXONsh",
    "_links": {
        "self": {
            "href": "/v1/events/EV-YtbNK8AxWHJbMukXONsh"
        }
    },
    "event": {
        "event_type": "business_created",
        "event_status": "PROCESSED",
        "data": {
            "entity_token": "B-4x8WzjvGz5Oz8RWA6MvY",
            "external_entity_id": "e3065d04-95aa-47a1-915c-84b575ff3855",
            "created_at": 1711404359986,
            "business_name": "Operative Inc.",
            "business_alternate_name": null,
            "business_federal_ein": "586179405",
            "business_registry_id": null,
            "addresses": [
                {
                    "line_1": "123 Allen St",
                    "line_2": "Suite 1",
                    "city": "New York",
                    "state": "NY",
                    "postal_code": "10002",
                    "created_at": 1711404359538,
                    "type": "business_primary",
                    "evaluation_token": null
                }
            ],
            "emails": [
                {
                    "email_address": "example@alloy.com"
                }
            ],
            "phones": [],
            "type": "business",
            "_links": {
                "self": {
                    "href": "/v1/entities/businesses/B-4x8WzjvGz5Oz8RWA6MvY"
                }
            }
        },
        "evaluations": [],
        "journey_applications": []
    }
}
```