Sign inBook a demo
HomeGuidesAPI ReferenceGlossary
HomeGuidesAPI ReferenceGlossary
  • API Reference
Logo
Sign inBook a demo
API ReferenceEntityBulk

POST
https://api.mercoa.com/entities
POST
/entities
1curl -X POST https://api.mercoa.com/entities \
2     -H "Authorization: Bearer <token>" \
3     -H "Content-Type: application/json" \
4     -d '{
5  "connectedEntity": {
6    "id": "ent_a0f6ea94-0761-4a5e-a416-3c453cb7eced",
7    "linkCreatedAsPayor": false,
8    "linkCreatedAsPayee": true
9  },
10  "entities": [
11    {
12      "isCustomer": true,
13      "isPayor": true,
14      "isPayee": false,
15      "accountType": "business",
16      "foreignId": "MY-DB-ID-12345",
17      "profile": {
18        "business": {
19          "email": "customer@acme.com",
20          "legalBusinessName": "Acme Inc.",
21          "website": "http://www.acme.com",
22          "businessType": "llc",
23          "phone": {
24            "countryCode": "1",
25            "number": "4155551234"
26          },
27          "address": {
28            "addressLine1": "123 Main St",
29            "addressLine2": "Unit 1",
30            "city": "San Francisco",
31            "stateOrProvince": "CA",
32            "postalCode": "94105",
33            "country": "US"
34          },
35          "taxId": {
36            "ein": {
37              "number": "12-3456789"
38            }
39          }
40        }
41      }
42    }
43  ]
44}'
Try it
200FromObjects
1{
2  "data": [
3    {
4      "id": "ent_21661ac1-a2a8-4465-a6c0-64474ba8181d",
5      "foreignId": "YOUR-ENTITY-ID"
6    },
7    {
8      "foreignId": "YOUR-SECOND-ENTITY-ID",
9      "error": "Entity creation failed"
10    }
11  ]
12}
Create multiple entities in bulk. This endpoint will process synchronously and return a list of entities that were created or failed to create.
Was this page helpful?
Previous

Download Bulk Entities (Sync)

Next
Built with
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

Create Bulk Entities (Sync)

Download Bulk Entities (Sync)

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