Create Organisation | emnify Documentation

Creates the specified organisation.

ID must not be specified, neither in query String, nor in JSON payload.

You can provide following fields with this request:

name (String required)
class (Object required)
type (Object required)
country (Object required)
relation (Object required) see /api/v1/organisation/relation/type for a lookup
status (Object optional)
currency (Object required)
verification_type (Object optional)
verification (String optional)
monthly_cost_limit (Integer optional)
ext_reference (String optional)

Notes

If the status field is not set at creation time, the default imposed by server is ENABLED.

Creates the specified organisation. ID must not be specified, neither in query String, nor in JSON payload. You can provide following fields with this request: * `name` (String required) * `class` (Object required) * `type` (Object required) * `country` (Object required) * `relation` (Object required) see /api/v1/organisation/relation/type for a lookup * `status` (Object optional) * `currency` (Object required) * `verification_type` (Object optional) * `verification` (String optional) * `monthly_cost_limit` (Integer optional) * `ext_reference` (String optional) **Notes** * If the status field is not set at creation time, the default imposed by server is ENABLED.

Authentication

AuthorizationBearer

An auth_token should be provided to authenticate a session.

To obtain an auth_token, see the POST request to /api/v1/authenticate.

Request

This endpoint expects an object.

namestringRequired

classobjectRequired

typeobjectRequired

countryobjectRequired

statusobjectRequired

relationobjectRequired

currencyobjectRequired

verification_typeobjectRequired

verificationstringRequired

ext_referencestringRequired

monthly_cost_limitintegerRequired

1	curl -X POST https://cdn.emnify.net/api/v1/organisation \
2	-H "Authorization: Bearer <token>" \
3	-H "Content-Type: application/json" \
4	-d '{
5	"name": "Tele17",
6	"class": {
7	"id": 0
8	},
9	"type": {
10	"id": 1
11	},
12	"country": {
13	"id": 12
14	},
15	"status": {
16	"id": 0
17	},
18	"relation": {
19	"type": {
20	"id": 0
21	}
22	},
23	"currency": {
24	"id": 1
25	},
26	"verification_type": {
27	"id": 1
28	},
29	"verification": "XYZ123",
30	"ext_reference": "ref",
31	"monthly_cost_limit": 1000
32	}'

Authentication

Request

Response