---
title: "Entity Created"
method: POST
path: "webhooks_entityCreated"
---

# Entity Created

`POST webhooks_entityCreated` (webhook)

A new entity was created

## Payload

- WebhooksEntityWebhook
  - `eventType` string, required: The type of the event.
  - `entity` EntityTypesEntityResponse, required
    - `id` string, required
    - `name` string, required
    - `email` string, required
    - `foreignId` string: The ID used to identify this entity in your system
    - `emailTo` string: Local-part/username of the email address to which to send invoices to be added to the Invoice Inbox.
    - `emailToAlias` string[]: Email inbox alias addresses. Used when forwarding emails to the emailTo address from an alias.
    - `isCustomer` boolean, required: True if this entity has a direct relationship with your organization.
    - `accountType` 'business' | 'individual', required
    - `profile` EntityTypesProfileResponse, required
      - `business` EntityTypesBusinessProfileResponse
        - `email` string
        - `legalBusinessName` string, required
        - `businessType` 'soleProprietorship' | 'unincorporatedAssociation' | 'trust' | 'publicCorporation' | 'privateCorporation' | 'llc' | 'partnership' | 'unincorporatedNonProfit' | 'incorporatedNonProfit'
        - `phone` CommonsPhoneNumber
          - `countryCode` string, required
          - `number` string, required
        - `doingBusinessAs` string
        - `website` string
        - `description` string
        - `address` CommonsAddress
          - `addressLine1` string, required
          - `addressLine2` string
          - `city` string, required
          - `stateOrProvince` string, required: State or province code. Must be in the format XX.
          - `postalCode` string, required: Postal code. Must be in the format XXXXX or XXXXX-XXXX.
          - `country` string
        - `ownersProvided` boolean: True if all representatives have been provided for this business.
        - `taxIDProvided` boolean, required
        - `taxId` EntityTypesTaxID
          - `ein` EntityTypesEin, required
            - `number` string, required: Must be in the format XX-XXXXXXX.
        - `formationDate` string, date-time
        - `industryCodes` EntityTypesIndustryCodes
          - `mcc` string
        - `averageMonthlyTransactionVolume` number, double
        - `averageTransactionSize` number, double
        - `maxTransactionSize` number, double
      - `individual` EntityTypesIndividualProfileResponse
        - `email` string
        - `name` CommonsFullName, required
          - `firstName` string, required
          - `middleName` string
          - `lastName` string, required
          - `suffix` string
        - `phone` CommonsPhoneNumber
          - `countryCode` string, required
          - `number` string, required
        - `address` CommonsAddress
          - `addressLine1` string, required
          - `addressLine2` string
          - `city` string, required
          - `stateOrProvince` string, required: State or province code. Must be in the format XX.
          - `postalCode` string, required: Postal code. Must be in the format XXXXX or XXXXX-XXXX.
          - `country` string
        - `birthDateProvided` boolean, required
        - `governmentIDProvided` boolean, required
    - `logo` string: URL for the entity logo
    - `status` 'unverified' | 'pending' | 'resubmit' | 'review' | 'verified' | 'failed', required
    - `oatfiStatus` string: The OatFi status of this entity
    - `oatfiUnderwritingResponse` object: The OatFi underwriting response of this entity
    - `acceptedTos` boolean, required: True if this entity has accepted the terms of service.
    - `isPayor` boolean, required: True if this entity can pay invoices.
    - `isPayee` boolean, required: True if this entity can receive payments.
    - `isNetworkPayor` boolean, required: True if this entity is available as a payor to any entity on your platform. Otherwise this entity will only be available as a payor to entities that have a direct relationship with this entity.
    - `isNetworkPayee` boolean, required: True if this entity is available as a payee to any entity on your platform. Otherwise this entity will only be available as a payee to entities that have a direct relationship with this entity.
    - `metadata` object: Simple key/value metadata associated with this entity. For more complex metadata, use the Metadata API.
    - `createdAt` string, date-time, required
    - `updatedAt` string, date-time, required
  - `updatedByEntityId` string, required
  - `user` EntityTypesEntityUserResponse
    - `id` string, required
    - `foreignId` string: The ID used to identify this user in your system.
    - `email` string
    - `name` string
    - `roles` string[], required
    - `createdAt` string, date-time, required
    - `updatedAt` string, date-time, required

## Acknowledgement `200`

Webhook received successfully

---

[API](https://skmtc.dev/mercoa/apis/mercoa-2.md) - [All operations](https://skmtc.dev/mercoa/apis/mercoa-2/llms.txt) - [OpenAPI document](https://skmtc.dev/mercoa/apis/mercoa-2/revisions/00a8e403ae18?raw)