Create Bulk Entities (Sync) | Mercoa

from mercoa import Mercoa
from mercoa.commons import Address, PhoneNumber
from mercoa.entity_types import (
    BulkConnectedEntity,
    BulkEntityCreationFromObject,
    BusinessProfileRequest,
    Ein,
    EntityCreationRequest,
    ProfileRequest,
    TaxId,
)
client = Mercoa(
    token="YOUR_TOKEN",
)
client.entity.bulk.create(
    request=BulkEntityCreationFromObject(
        connected_entity=BulkConnectedEntity(
            id="ent_a0f6ea94-0761-4a5e-a416-3c453cb7eced",
            link_created_as_payor=False,
            link_created_as_payee=True,
        ),
        entities=[
            EntityCreationRequest(
                is_customer=True,
                is_payor=True,
                is_payee=False,
                account_type="business",
                foreign_id="MY-DB-ID-12345",
                profile=ProfileRequest(
                    business=BusinessProfileRequest(
                        email="customer@acme.com",
                        legal_business_name="Acme Inc.",
                        website="http://www.acme.com",
                        business_type="llc",
                        phone=PhoneNumber(
                            country_code="1",
                            number="4155551234",
                        ),
                        address=Address(
                            address_line_1="123 Main St",
                            address_line_2="Unit 1",
                            city="San Francisco",
                            state_or_province="CA",
                            postal_code="94105",
                            country="US",
                        ),
                        tax_id=TaxId(
                            ein=Ein(
                                number="12-3456789",
                            ),
                        ),
                    ),
                ),
            )
        ],
    ),
)

{
  "data": [
    {
      "id": "ent_21661ac1-a2a8-4465-a6c0-64474ba8181d",
      "foreignId": "YOUR-ENTITY-ID"
    },
    {
      "foreignId": "YOUR-SECOND-ENTITY-ID",
      "error": "Entity creation failed"
    }
  ]
}

Create multiple entities in bulk. This endpoint will process synchronously and return a list of entities that were created or failed to create.

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Query parameters

emitWebhooksbooleanOptionalDefaults to false

If true, webhooks will be emitted for each entity that is created. By default, webhooks are not emitted.

Request

This endpoint expects an object.

Bulk Entity Creation from ObjectobjectRequired

Response

This endpoint returns an object.

datalist of objects

Errors

400

Bad Request

401

Unauthorized

403

Forbidden

404

Not Found

409

Conflict

500

Internal Server Error

501

Unimplemented