Create an Account
POST Create an Account
https://api.moltin.com/v2/accounts/
Parameters
Headers
| Name | Required | Type | Description |
|---|---|---|---|
Authorization | Required | string | The Bearer token required to get access to the API. |
Body
| Name | Required | Type | Description |
|---|---|---|---|
type | Required | string | Specifies the the type of object. Set this value to account. |
name | Required | string | Specifies the name of the account. |
legal_name | Required | string | Specifies the legal name of the account. |
registration_id | Optional | string | Specifies the registration ID. If specified, this field is checked for uniqueness. |
parent_id | Optional | string | Specifies the ID of the parent account. |
Request Examples
Curl
curl -X POST https://api.moltin.com/v2/accounts \
-H "Authorization: Bearer XXXX" \
-H "Content-Type: application/json" \
-d $'{
"data": {
"type": "account",
"name": "acc-name",
"legal_name": "acc-legal-name",
"registration_id": "00000000-0000-1000-8000-000f00000300",
"parent_id": "96b1f750-55d3-4768-a3f8-adffba694a2c"
}
}'
JavaScript SDK
const MoltinGateway = require("@moltin/sdk").gateway;
const Moltin = MoltinGateway({
client_id: "X",
client_secret: "X",
});
const account = {
type: "account",
name: "acc-name",
legal_name: "acc-legal-name",
registration_id: "00000000-0000-1000-8000-000f00000300",
parent_id: "96b1f750-55d3-4768-a3f8-adffba694a2c",
};
Moltin.Accounts.Create(account).then((acc) => {
// Do something
});
Response Example
201 Created
{
"data": {
"id": "deb6b25f-8451-4211-9a22-95610333df23",
"type": "account",
"name": "acc-name",
"legal_name": "acc-legal-name",
"company_address": "company address",
"registration_id": "00000000-0000-1000-8000-000f00000300",
"relationships": {
"parent": {
"data": {
"id": "96b1f750-55d3-4768-a3f8-adffba694a2c",
"type": "account"
}
},
"ancestors": [
{
"data": {
"id": "96b1f750-55d3-4768-a3f8-adffba694a2c",
"type": "account"
}
}
]
},
"meta": {
"timestamps": {
"created_at": "2021-02-23T09:40:33.882Z",
"updated_at": "2021-02-23T09:40:33.882Z"
}
}
},
"links": {
"self": "https://api.moltin.com/v2/accounts/deb6b25f-8451-4211-9a22-95610333df23"
}
}