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

typeenumRequired

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": "individual", 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": "id", 13 "individual": { 14 "first_name": "first_name", 15 "last_name": "last_name", 16 "date_of_birth": "date_of_birth", 17 "id_number": "id_number", 18 "ssn_last_4": "ssn_last_4", 19 "title": "title" 20 }, 21 "status": "active", 22 "updated_at": "2024-01-15T09:30:00Z", 23 "email": "email", 24 "logo": { 25 "id": "id", 26 "created_at": "2024-01-15T09:30:00Z", 27 "file_type": "payables", 28 "md5": "31d1a2dd1ad3dfc39be849d70a68dac0", 29 "mimetype": "application/pdf", 30 "name": "invoice.pdf", 31 "region": "eu-central-1", 32 "size": 24381, 33 "url": "https://bucketname.s3.amazonaws.com/12345/67890.pdf", 34 "pages": [ 35 { 36 "id": "id", 37 "mimetype": "image/png", 38 "number": 0, 39 "size": 21972, 40 "url": "https://bucket.s3.amazonaws.com/123/456.png" 41 } 42 ], 43 "previews": [ 44 { 45 "height": 400, 46 "url": "https://bucketname.s3.amazonaws.com/1/2/3.png", 47 "width": 200 48 } 49 ] 50 }, 51 "phone": "phone", 52 "tax_id": "tax_id", 53 "website": "website" 54 }

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": "individual",
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": "id",
13	"individual": {
14	"first_name": "first_name",
15	"last_name": "last_name",
16	"date_of_birth": "date_of_birth",
17	"id_number": "id_number",
18	"ssn_last_4": "ssn_last_4",
19	"title": "title"
20	},
21	"status": "active",
22	"updated_at": "2024-01-15T09:30:00Z",
23	"email": "email",
24	"logo": {
25	"id": "id",
26	"created_at": "2024-01-15T09:30:00Z",
27	"file_type": "payables",
28	"md5": "31d1a2dd1ad3dfc39be849d70a68dac0",
29	"mimetype": "application/pdf",
30	"name": "invoice.pdf",
31	"region": "eu-central-1",
32	"size": 24381,
33	"url": "https://bucketname.s3.amazonaws.com/12345/67890.pdf",
34	"pages": [
35	{
36	"id": "id",
37	"mimetype": "image/png",
38	"number": 0,
39	"size": 21972,
40	"url": "https://bucket.s3.amazonaws.com/123/456.png"
41	}
42	],
43	"previews": [
44	{
45	"height": 400,
46	"url": "https://bucketname.s3.amazonaws.com/1/2/3.png",
47	"width": 200
48	}
49	]
50	},
51	"phone": "phone",
52	"tax_id": "tax_id",
53	"website": "website"
54	}