Create an entity — Monite Documentation

Create a new entity from the specified values.

Headers

Auth

AuthorizationstringRequired

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

x-monite-versionstringRequired

Request

This endpoint expects an object.

addressobjectRequired

An address description of the entity

emailstringRequiredformat: "email"

An official email address of the entity

type"individual" or "organization"Required

Allowed values: individualorganization

A type for an entity

phonestringOptional<=100 characters

The contact phone number of the entity. Required for US organizations to use payments.

websitestringOptionalformat: "uri">=1 character<=2083 characters

A website of the entity

organizationobjectOptional

A set of meta data describing the organization

individualobjectOptional

A set of meta data describing the individual

tax_idstringOptional>=1 character<=30 characters

The entity’s taxpayer identification number or tax ID. This field is required for entities that are non-VAT registered.

Response

Successful Response

Individual

Organization

Errors

1 curl -X POST https://api.sandbox.monite.com/v1/entities \ 2 -H "x-monite-version: 2024-05-25" \ 3 -H "Authorization: Bearer <token>" \ 4 -H "Content-Type: application/json" \ 5 -d '{ 6 "address": { 7 "city": "city", 8 "country": "AF", 9 "line1": "line1", 10 "postal_code": "postal_code" 11 }, 12 "email": "email", 13 "type": "individual" 14 }'

1 { 2 "type": "organization", 3 "address": { 4 "city": "city", 5 "country": "AF", 6 "line1": "line1", 7 "postal_code": "postal_code", 8 "line2": "line2", 9 "state": "state" 10 }, 11 "created_at": "2024-01-15T09:30:00Z", 12 "id": "string", 13 "organization": { 14 "legal_name": "legal_name", 15 "business_structure": "incorporated_partnership", 16 "directors_provided": true, 17 "executives_provided": true, 18 "legal_entity_id": "legal_entity_id", 19 "owners_provided": true, 20 "representative_provided": true 21 }, 22 "status": "active", 23 "updated_at": "2024-01-15T09:30:00Z", 24 "email": "string", 25 "logo": { 26 "id": "id", 27 "created_at": "2024-01-15T09:30:00Z", 28 "file_type": "payables", 29 "md5": "31d1a2dd1ad3dfc39be849d70a68dac0", 30 "mimetype": "application/pdf", 31 "name": "invoice.pdf", 32 "region": "eu-central-1", 33 "size": 24381, 34 "url": "https://bucketname.s3.amazonaws.com/12345/67890.pdf", 35 "pages": [ 36 { 37 "id": "id", 38 "mimetype": "image/png", 39 "number": 0, 40 "size": 21972, 41 "url": "https://bucket.s3.amazonaws.com/123/456.png" 42 } 43 ], 44 "previews": [ 45 { 46 "height": 400, 47 "url": "https://bucketname.s3.amazonaws.com/1/2/3.png", 48 "width": 200 49 } 50 ] 51 }, 52 "phone": "string", 53 "tax_id": "string", 54 "website": "string" 55 }

1	curl -X POST https://api.sandbox.monite.com/v1/entities \
2	-H "x-monite-version: 2024-05-25" \
3	-H "Authorization: Bearer <token>" \
4	-H "Content-Type: application/json" \
5	-d '{
6	"address": {
7	"city": "city",
8	"country": "AF",
9	"line1": "line1",
10	"postal_code": "postal_code"
11	},
12	"email": "email",
13	"type": "individual"
14	}'

1	{
2	"type": "organization",
3	"address": {
4	"city": "city",
5	"country": "AF",
6	"line1": "line1",
7	"postal_code": "postal_code",
8	"line2": "line2",
9	"state": "state"
10	},
11	"created_at": "2024-01-15T09:30:00Z",
12	"id": "string",
13	"organization": {
14	"legal_name": "legal_name",
15	"business_structure": "incorporated_partnership",
16	"directors_provided": true,
17	"executives_provided": true,
18	"legal_entity_id": "legal_entity_id",
19	"owners_provided": true,
20	"representative_provided": true
21	},
22	"status": "active",
23	"updated_at": "2024-01-15T09:30:00Z",
24	"email": "string",
25	"logo": {
26	"id": "id",
27	"created_at": "2024-01-15T09:30:00Z",
28	"file_type": "payables",
29	"md5": "31d1a2dd1ad3dfc39be849d70a68dac0",
30	"mimetype": "application/pdf",
31	"name": "invoice.pdf",
32	"region": "eu-central-1",
33	"size": 24381,
34	"url": "https://bucketname.s3.amazonaws.com/12345/67890.pdf",
35	"pages": [
36	{
37	"id": "id",
38	"mimetype": "image/png",
39	"number": 0,
40	"size": 21972,
41	"url": "https://bucket.s3.amazonaws.com/123/456.png"
42	}
43	],
44	"previews": [
45	{
46	"height": 400,
47	"url": "https://bucketname.s3.amazonaws.com/1/2/3.png",
48	"width": 200
49	}
50	]
51	},
52	"phone": "string",
53	"tax_id": "string",
54	"website": "string"
55	}