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

Required API Field	Definition	Notes
`timestamp`	Timestamp of the event.
One of: `external_entity_id` `entity_token`	Unique identifier for the Entity.	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.

Example Request/Response

{
    "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": "[email protected]"
        }],
        "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": {
            "channel": "online"
        }
    }
}

{
    "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": "[email protected]"
                }
            ],
            "phones": [],
            "type": "business",
            "_links": {
                "self": {
                    "href": "/v1/entities/businesses/B-4x8WzjvGz5Oz8RWA6MvY"
                }
            }
        },
        "evaluations": [],
        "journey_applications": []
    }
}

Updated 2 months ago