1 of 10

Account

Account Object

The account object represents an individual account on the Marketplace platform. This object contains the following properties:

Field

Type

Description

id

string

Primary account identifier.

Example: "ACC-1671-0642"

href

string

Relative reference to object on API.

Example: "/v1/accounts/accounts/ACC-1671-0642"

type

string

Type of the account (Client, Vendor, Operations)

Example: "Client"

status

string

Status of the account (Enabled, Active, Disabled)

Example: "Enabled"

name

string

Account name.

Example: "Stark Industries"

description

string

Account description.

Example: "Our company account"

externalId

string

External identifier - Customer Discount Group number.

Example: "WW-1001111"

externalName

string

External identifier - Customer Discount Group name.

Example: "Stark Industries"

serviceLevel

string

Service level offered to the account (Essential, Elite, DSC)

Example: "Elite"

address

object

Address of the company.

Example:

{
  "addressLine1": "123 Main Street",
  "addressLine2": "Apt 4B",
  "postCode": "12345",
  "city": "Cityville",
  "state": "S",
  "country": "ST"
}

icon

string

Relative path to account logo.

Example: "/static/accounts/ACC-1671-0642/logo.png"

website

string

Path to company’s website.

Example: "https://www.example.com"

technicalSupportEmail

string

Technical support email for some corner cases.

Example: "user@example.com"

audit

object

Possible audit events: Created, Updated, Disabled, Enabled, or Activated.

Example:

{
  "created": { "at": "...", "by": { } },
  "updated": { "at": "...", "by": { } },
  "disabled": { "at": "...", "by": { } },
  "enabled": { "at": "...", "by": { } },
  "activated": { "at": "...", "by": { } }
}

groups

Example

{
  "id": "ACC-1671-0642",
  "href": "/accounts/accounts/ACC-1671-0642",
  "type": "Client",
  "status": "Enabled",
  "name": "You Are a Test Account",
  "description": "This is a test account.",
  "externalId": "WW-1001111",
  "serviceLevel": "Express",
  "address": {
    "addressLine1": "123 Main Street",
    "addressLine2": "Apt 4B",
    "postCode": "12345",
    "city": "Cityville",
    "state": "S",
    "country": "ST"
  },
  "logo": null,
  "technicalSupportEmail": "user@example.com",
  "website": "https://example.com"  
}

{
  "id": "ACC-1671-0642",
  "href": "/accounts/accounts/ACC-1671-0642",
  "type": "Client",
  "status": "Enabled",
  "name": "You Are a Test Account",
  "description": "This is a test account.",
  "externalId": "WW-1001111",
  "serviceLevel": "Express",
  "address": {
    "addressLine1": "123 Main Street",
    "addressLine2": "Apt 4B",
    "postCode": "12345",
    "city": "Cityville",
    "state": "S",
    "country": "ST"
  },
  "logo": null,
  "technicalSupportEmail": "user@example.com",
  "website": "https://example.com",
  "groups": [
		{
			"id": "UGR-9354-3382",
			"href": "/user-groups/UGR-9354-3382",
			"name": "Administrators",
			"description": "Manages administrative tasks and resources within an organization.",
			"logo": null,
			"isDefault": true
		}
  ],
  {
    "created": { "at": "2023-12-14T17:28:57.667Z", "by": { "id": "USR-1234-1234", "name": "John Smith" } },
    "updated": { "at": "2023-12-14T17:28:57.667Z", "by": { "id": "USR-1234-1234", "name": "John Smith" } },
    "disabled": { "at": "2023-12-14T17:28:57.667Z", "by": { "id": "USR-1234-1234", "name": "John Smith" } },
    "enabled": { "at": "2023-12-14T17:28:57.667Z", "by": { "id": "USR-1234-1234", "name": "John Smith" } },
    "activated": { "at": "2023-12-14T17:28:57.667Z", "by": { "id": "USR-1234-1234", "name": "John Smith" } }
  }
}

List Accounts

Create Account

Create a new Client or Vendor Account object.

Enable Account

Enable the previously disabled Account object.

When enabled, the account status will change to Active if the account has ExternalId assigned or Enabled otherwise.

Disable Account

Disable the Account object. Disabling prevents users from signing in.

Activate Account

Activate a previously enabled Account object.

Get Account

Get a single Account object by ID.

Update Account

Update the Account object.

Validate Account

Validate the Account object.

Get Account Icon

Get an account icon.

Account

Account Object

The account object represents an individual account on the Marketplace platform. This object contains the following properties:

Field

Type

Description

id

string

Primary account identifier.

Example: "ACC-1671-0642"

href

string

Relative reference to object on API.

Example: "/v1/accounts/accounts/ACC-1671-0642"

type

string

Type of the account (Client, Vendor, Operations)

Example: "Client"

status

string

Status of the account (Enabled, Active, Disabled)

Example: "Enabled"

name

string

Account name.

Example: "Stark Industries"

description

string

Account description.

Example: "Our company account"

externalId

string

External identifier - Customer Discount Group number.

Example: "WW-1001111"

externalName

string

External identifier - Customer Discount Group name.

Example: "Stark Industries"

serviceLevel

string

Service level offered to the account (Essential, Elite, DSC)

Example: "Elite"

address

object

Address of the company.

Example:

{
  "addressLine1": "123 Main Street",
  "addressLine2": "Apt 4B",
  "postCode": "12345",
  "city": "Cityville",
  "state": "S",
  "country": "ST"
}

icon

string

Relative path to account logo.

Example: "/static/accounts/ACC-1671-0642/logo.png"

website

string

Path to company’s website.

Example: "https://www.example.com"

technicalSupportEmail

string

Technical support email for some corner cases.

Example: "user@example.com"

audit

object

Possible audit events: Created, Updated, Disabled, Enabled, or Activated.

Example:

{
  "created": { "at": "...", "by": { } },
  "updated": { "at": "...", "by": { } },
  "disabled": { "at": "...", "by": { } },
  "enabled": { "at": "...", "by": { } },
  "activated": { "at": "...", "by": { } }
}

groups

Example

{
  "id": "ACC-1671-0642",
  "href": "/accounts/accounts/ACC-1671-0642",
  "type": "Client",
  "status": "Enabled",
  "name": "You Are a Test Account",
  "description": "This is a test account.",
  "externalId": "WW-1001111",
  "serviceLevel": "Express",
  "address": {
    "addressLine1": "123 Main Street",
    "addressLine2": "Apt 4B",
    "postCode": "12345",
    "city": "Cityville",
    "state": "S",
    "country": "ST"
  },
  "logo": null,
  "technicalSupportEmail": "user@example.com",
  "website": "https://example.com"  
}

{
  "id": "ACC-1671-0642",
  "href": "/accounts/accounts/ACC-1671-0642",
  "type": "Client",
  "status": "Enabled",
  "name": "You Are a Test Account",
  "description": "This is a test account.",
  "externalId": "WW-1001111",
  "serviceLevel": "Express",
  "address": {
    "addressLine1": "123 Main Street",
    "addressLine2": "Apt 4B",
    "postCode": "12345",
    "city": "Cityville",
    "state": "S",
    "country": "ST"
  },
  "logo": null,
  "technicalSupportEmail": "user@example.com",
  "website": "https://example.com",
  "groups": [
		{
			"id": "UGR-9354-3382",
			"href": "/user-groups/UGR-9354-3382",
			"name": "Administrators",
			"description": "Manages administrative tasks and resources within an organization.",
			"logo": null,
			"isDefault": true
		}
  ],
  {
    "created": { "at": "2023-12-14T17:28:57.667Z", "by": { "id": "USR-1234-1234", "name": "John Smith" } },
    "updated": { "at": "2023-12-14T17:28:57.667Z", "by": { "id": "USR-1234-1234", "name": "John Smith" } },
    "disabled": { "at": "2023-12-14T17:28:57.667Z", "by": { "id": "USR-1234-1234", "name": "John Smith" } },
    "enabled": { "at": "2023-12-14T17:28:57.667Z", "by": { "id": "USR-1234-1234", "name": "John Smith" } },
    "activated": { "at": "2023-12-14T17:28:57.667Z", "by": { "id": "USR-1234-1234", "name": "John Smith" } }
  }
}

post

/v1/accounts/accounts/{id}/activate

Path parameters

idstringrequired

Body

idstring

auditobject

$metaobject

hrefstring

externalIdsobject

externalIdstring · min: 1 · max: 250required

externalNamestring | nullable

typestring · enum

Options: Client, Vendor, Operations

statusstring · enum

Options: Active, Enabled, Disabled

serviceLevelstring · enum

Options: Express, Elite, Dsc, Focus, Runners, Strategics, NotApplicable

addressobject

iconstring | nullable

technicalSupportEmailstring · email · max: 320 | nullable

websitestring · max: 2000 | nullable

descriptionstring · max: 2000 | nullable

namestring · min: 1 · max: 500required

groupsobject[] | nullable

Responses

application/json

cURL

JavaScript

Python

HTTP

curl -L \
  --request POST \
  --url '/v1/accounts/accounts/{id}/activate' \
  --header 'Content-Type: application/json' \
  --data '{"audit":{"created":{"by":{"audit":{"created":{"by":"[Circular Reference]"},"updated":{"by":"[Circular Reference]"}},"$meta":{"omitted":[null]}}},"updated":{"by":"[Circular Reference]"}},"$meta":{"omitted":[null]},"externalIds":{},"externalId":"text","type":"Client","status":"Active","serviceLevel":"Express","address":{"addressLine1":"text","postCode":"text","city":"text","state":"text","country":"text"},"name":"text","groups":[{"audit":{"created":{"by":{"audit":{"created":{"by":"[Circular Reference]"},"updated":{"by":"[Circular Reference]"}},"$meta":{"omitted":[null]}}},"updated":{"by":"[Circular Reference]"}},"$meta":{"omitted":[null]},"account":{"audit":{"created":{"by":{"audit":{"created":{"by":"[Circular Reference]"},"updated":{"by":"[Circular Reference]"}},"$meta":{"omitted":[null]}}},"updated":{"by":"[Circular Reference]"}},"$meta":{"omitted":[null]},"externalIds":{},"type":"Client","status":"Active","serviceLevel":"Express","address":{"addressLine1":"text","postCode":"text","city":"text","state":"text","country":"text"},"name":"text","groups":[{"audit":{"created":{"by":{"audit":{"created":{"by":"[Circular Reference]"},"updated":{"by":"[Circular Reference]"}},"$meta":{"omitted":[null]}}},"updated":{"by":"[Circular Reference]"}},"$meta":{"omitted":[null]},"account":"[Circular Reference]","modules":"[Circular Reference]","users":"[Circular Reference]","buyers":"[Circular Reference]"}]},"modules":[{"audit":{"created":{"by":{"audit":{"created":{"by":"[Circular Reference]"},"updated":{"by":"[Circular Reference]"}},"$meta":{"omitted":[null]}}},"updated":{"by":"[Circular Reference]"}},"$meta":{"omitted":[null]},"filters":{"group.buyers":[null]},"settings":{"type":[null]},"accountTypes":[null]}],"users":[{"audit":{"created":"[Circular Reference]","updated":"[Circular Reference]"},"$meta":{"omitted":[null]},"phone":{},"settings":{},"currentAccount":{"audit":{"created":{"by":{"audit":{"created":{"by":"[Circular Reference]"},"updated":{"by":"[Circular Reference]"}},"$meta":{"omitted":[null]}}},"updated":{"by":"[Circular Reference]"}},"$meta":{"omitted":[null]},"externalIds":{},"type":"Client","status":"Active","serviceLevel":"Express","address":{"addressLine1":"text","postCode":"text","city":"text","state":"text","country":"text"},"name":"text","groups":"[Circular Reference]"},"accounts":["[Circular Reference]"]}],"buyers":[{"audit":{"created":"[Circular Reference]","updated":"[Circular Reference]","activated":"[Circular Reference]","unassigned":"[Circular Reference]"},"$meta":{"omitted":[null]},"contact":{"phone":{},"user":"[Circular Reference]"},"externalIds":{},"status":"Active","address":{"addressLine1":"text","postCode":"text","city":"text","state":"text","country":"text"},"account":{"audit":{"created":{"by":{"audit":{"created":{"by":"[Circular Reference]"},"updated":{"by":"[Circular Reference]"}},"$meta":{"omitted":[null]}}},"updated":{"by":"[Circular Reference]"}},"$meta":{"omitted":[null]},"externalIds":{},"type":"Client","status":"Active","serviceLevel":"Express","address":{"addressLine1":"text","postCode":"text","city":"text","state":"text","country":"text"},"name":"text","groups":"[Circular Reference]"},"errors":[{"message":"text"}],"sellers":["[Circular Reference]"]}]}]}'

200

400

404

{
  "id": "text",
  "audit": {
    "created": {
      "by": {
        "audit": {
          "created": {
            "by": "[Circular Reference]"
          },
          "updated": {
            "by": "[Circular Reference]"
          }
        },
        "$meta": {
          "omitted": [
            null
          ]
        }
      }
    },
    "updated": {
      "by": "[Circular Reference]"
    }
  },
  "$meta": {
    "omitted": [
      null
    ]
  },
  "href": "text",
  "externalIds": {},
  "externalId": "text",
  "externalName": "text",
  "type": "Client",
  "status": "Active",
  "serviceLevel": "Express",
  "address": {
    "addressLine1": "text",
    "postCode": "text",
    "city": "text",
    "state": "text",
    "country": "text"
  },
  "icon": "text",
  "technicalSupportEmail": "hello@example.com",
  "website": "text",
  "description": "text",
  "name": "text",
  "groups": [
    {
      "audit": {
        "created": {
          "by": {
            "audit": {
              "created": {
                "by": "[Circular Reference]"
              },
              "updated": {
                "by": "[Circular Reference]"
              }
            },
            "$meta": {
              "omitted": [
                null
              ]
            }
          }
        },
        "updated": {
          "by": "[Circular Reference]"
        }
      },
      "$meta": {
        "omitted": [
          null
        ]
      },
      "account": "[Circular Reference]",
      "modules": "[Circular Reference]",
      "users": "[Circular Reference]",
      "buyers": "[Circular Reference]"
    }
  ]
}

post

/v1/accounts/accounts

Body

idstring

auditobject

$metaobject

hrefstring

externalIdsobject

externalIdstring · max: 250 | nullable

externalNamestring | nullable

typestring · enumrequired

Options: Client, Vendor, Operations

statusstring · enum

Options: Active, Enabled, Disabled

serviceLevelstring · enumrequired

Options: Express, Elite, Dsc, Focus, Runners, Strategics, NotApplicable

addressobject

iconstring | nullable

technicalSupportEmailstring · email · max: 320 | nullable

websitestring · max: 2000 | nullable

descriptionstring · max: 2000 | nullable

namestring · min: 1 · max: 500required

groupsobject[] | nullable

Responses

application/json

cURL

JavaScript

Python

HTTP

curl -L \
  --request POST \
  --url '/v1/accounts/accounts' \
  --header 'Content-Type: application/json' \
  --data '{"audit":{"created":{"by":{"audit":{"created":{"by":"[Circular Reference]"},"updated":{"by":"[Circular Reference]"}},"$meta":{"omitted":[null]}}},"updated":{"by":"[Circular Reference]"}},"$meta":{"omitted":[null]},"externalIds":{},"type":"Client","status":"Active","serviceLevel":"Express","address":{"addressLine1":"text","postCode":"text","city":"text","state":"text","country":"text"},"name":"text","groups":[{"audit":{"created":{"by":{"audit":{"created":{"by":"[Circular Reference]"},"updated":{"by":"[Circular Reference]"}},"$meta":{"omitted":[null]}}},"updated":{"by":"[Circular Reference]"}},"$meta":{"omitted":[null]},"account":{"audit":{"created":{"by":{"audit":{"created":{"by":"[Circular Reference]"},"updated":{"by":"[Circular Reference]"}},"$meta":{"omitted":[null]}}},"updated":{"by":"[Circular Reference]"}},"$meta":{"omitted":[null]},"externalIds":{},"type":"Client","status":"Active","serviceLevel":"Express","address":{"addressLine1":"text","postCode":"text","city":"text","state":"text","country":"text"},"name":"text","groups":[{"audit":{"created":{"by":{"audit":{"created":{"by":"[Circular Reference]"},"updated":{"by":"[Circular Reference]"}},"$meta":{"omitted":[null]}}},"updated":{"by":"[Circular Reference]"}},"$meta":{"omitted":[null]},"account":"[Circular Reference]","modules":"[Circular Reference]","users":"[Circular Reference]","buyers":"[Circular Reference]"}]},"modules":[{"audit":{"created":{"by":{"audit":{"created":{"by":"[Circular Reference]"},"updated":{"by":"[Circular Reference]"}},"$meta":{"omitted":[null]}}},"updated":{"by":"[Circular Reference]"}},"$meta":{"omitted":[null]},"filters":{"group.buyers":[null]},"settings":{"type":[null]},"accountTypes":[null]}],"users":[{"audit":{"created":"[Circular Reference]","updated":"[Circular Reference]"},"$meta":{"omitted":[null]},"phone":{},"settings":{},"currentAccount":{"audit":{"created":{"by":{"audit":{"created":{"by":"[Circular Reference]"},"updated":{"by":"[Circular Reference]"}},"$meta":{"omitted":[null]}}},"updated":{"by":"[Circular Reference]"}},"$meta":{"omitted":[null]},"externalIds":{},"type":"Client","status":"Active","serviceLevel":"Express","address":{"addressLine1":"text","postCode":"text","city":"text","state":"text","country":"text"},"name":"text","groups":"[Circular Reference]"},"accounts":["[Circular Reference]"]}],"buyers":[{"audit":{"created":"[Circular Reference]","updated":"[Circular Reference]","activated":"[Circular Reference]","unassigned":"[Circular Reference]"},"$meta":{"omitted":[null]},"contact":{"phone":{},"user":"[Circular Reference]"},"externalIds":{},"status":"Active","address":{"addressLine1":"text","postCode":"text","city":"text","state":"text","country":"text"},"account":{"audit":{"created":{"by":{"audit":{"created":{"by":"[Circular Reference]"},"updated":{"by":"[Circular Reference]"}},"$meta":{"omitted":[null]}}},"updated":{"by":"[Circular Reference]"}},"$meta":{"omitted":[null]},"externalIds":{},"type":"Client","status":"Active","serviceLevel":"Express","address":{"addressLine1":"text","postCode":"text","city":"text","state":"text","country":"text"},"name":"text","groups":"[Circular Reference]"},"errors":[{"message":"text"}],"sellers":["[Circular Reference]"]}]}]}'

201

400

{
  "id": "text",
  "audit": {
    "created": {
      "by": {
        "audit": {
          "created": {
            "by": "[Circular Reference]"
          },
          "updated": {
            "by": "[Circular Reference]"
          }
        },
        "$meta": {
          "omitted": [
            null
          ]
        }
      }
    },
    "updated": {
      "by": "[Circular Reference]"
    }
  },
  "$meta": {
    "omitted": [
      null
    ]
  },
  "href": "text",
  "externalIds": {},
  "externalId": "text",
  "externalName": "text",
  "type": "Client",
  "status": "Active",
  "serviceLevel": "Express",
  "address": {
    "addressLine1": "text",
    "postCode": "text",
    "city": "text",
    "state": "text",
    "country": "text"
  },
  "icon": "text",
  "technicalSupportEmail": "hello@example.com",
  "website": "text",
  "description": "text",
  "name": "text",
  "groups": [
    {
      "audit": {
        "created": {
          "by": {
            "audit": {
              "created": {
                "by": "[Circular Reference]"
              },
              "updated": {
                "by": "[Circular Reference]"
              }
            },
            "$meta": {
              "omitted": [
                null
              ]
            }
          }
        },
        "updated": {
          "by": "[Circular Reference]"
        }
      },
      "$meta": {
        "omitted": [
          null
        ]
      },
      "account": "[Circular Reference]",
      "modules": "[Circular Reference]",
      "users": "[Circular Reference]",
      "buyers": "[Circular Reference]"
    }
  ]
}

Created

put

/v1/accounts/accounts/{id}

Path parameters

idstringrequired

Body

idstring

auditobject

$metaobject

hrefstring

externalIdsobject

externalIdstring · max: 250 | nullable

externalNamestring | nullable

typestring · enum

Options: Client, Vendor, Operations

statusstring · enum

Options: Active, Enabled, Disabled

serviceLevelstring · enum

Options: Express, Elite, Dsc, Focus, Runners, Strategics, NotApplicable

addressobject

iconstring | nullable

technicalSupportEmailstring · email · max: 320 | nullable

websitestring · max: 2000 | nullable

descriptionstring · max: 2000 | nullable

namestring · min: 1 · max: 500required

groupsobject[] | nullable

Responses

application/json

cURL

JavaScript

Python

HTTP

curl -L \
  --request PUT \
  --url '/v1/accounts/accounts/{id}' \
  --header 'Content-Type: application/json' \
  --data '{"audit":{"created":{"by":{"audit":{"created":{"by":"[Circular Reference]"},"updated":{"by":"[Circular Reference]"}},"$meta":{"omitted":[null]}}},"updated":{"by":"[Circular Reference]"}},"$meta":{"omitted":[null]},"externalIds":{},"type":"Client","status":"Active","serviceLevel":"Express","address":{"addressLine1":"text","postCode":"text","city":"text","state":"text","country":"text"},"name":"text","groups":[{"audit":{"created":{"by":{"audit":{"created":{"by":"[Circular Reference]"},"updated":{"by":"[Circular Reference]"}},"$meta":{"omitted":[null]}}},"updated":{"by":"[Circular Reference]"}},"$meta":{"omitted":[null]},"account":{"audit":{"created":{"by":{"audit":{"created":{"by":"[Circular Reference]"},"updated":{"by":"[Circular Reference]"}},"$meta":{"omitted":[null]}}},"updated":{"by":"[Circular Reference]"}},"$meta":{"omitted":[null]},"externalIds":{},"type":"Client","status":"Active","serviceLevel":"Express","address":{"addressLine1":"text","postCode":"text","city":"text","state":"text","country":"text"},"name":"text","groups":[{"audit":{"created":{"by":{"audit":{"created":{"by":"[Circular Reference]"},"updated":{"by":"[Circular Reference]"}},"$meta":{"omitted":[null]}}},"updated":{"by":"[Circular Reference]"}},"$meta":{"omitted":[null]},"account":"[Circular Reference]","modules":"[Circular Reference]","users":"[Circular Reference]","buyers":"[Circular Reference]"}]},"modules":[{"audit":{"created":{"by":{"audit":{"created":{"by":"[Circular Reference]"},"updated":{"by":"[Circular Reference]"}},"$meta":{"omitted":[null]}}},"updated":{"by":"[Circular Reference]"}},"$meta":{"omitted":[null]},"filters":{"group.buyers":[null]},"settings":{"type":[null]},"accountTypes":[null]}],"users":[{"audit":{"created":"[Circular Reference]","updated":"[Circular Reference]"},"$meta":{"omitted":[null]},"phone":{},"settings":{},"currentAccount":{"audit":{"created":{"by":{"audit":{"created":{"by":"[Circular Reference]"},"updated":{"by":"[Circular Reference]"}},"$meta":{"omitted":[null]}}},"updated":{"by":"[Circular Reference]"}},"$meta":{"omitted":[null]},"externalIds":{},"type":"Client","status":"Active","serviceLevel":"Express","address":{"addressLine1":"text","postCode":"text","city":"text","state":"text","country":"text"},"name":"text","groups":"[Circular Reference]"},"accounts":["[Circular Reference]"]}],"buyers":[{"audit":{"created":"[Circular Reference]","updated":"[Circular Reference]","activated":"[Circular Reference]","unassigned":"[Circular Reference]"},"$meta":{"omitted":[null]},"contact":{"phone":{},"user":"[Circular Reference]"},"externalIds":{},"status":"Active","address":{"addressLine1":"text","postCode":"text","city":"text","state":"text","country":"text"},"account":{"audit":{"created":{"by":{"audit":{"created":{"by":"[Circular Reference]"},"updated":{"by":"[Circular Reference]"}},"$meta":{"omitted":[null]}}},"updated":{"by":"[Circular Reference]"}},"$meta":{"omitted":[null]},"externalIds":{},"type":"Client","status":"Active","serviceLevel":"Express","address":{"addressLine1":"text","postCode":"text","city":"text","state":"text","country":"text"},"name":"text","groups":"[Circular Reference]"},"errors":[{"message":"text"}],"sellers":["[Circular Reference]"]}]}]}'

200

400

404

{
  "id": "text",
  "audit": {
    "created": {
      "by": {
        "audit": {
          "created": {
            "by": "[Circular Reference]"
          },
          "updated": {
            "by": "[Circular Reference]"
          }
        },
        "$meta": {
          "omitted": [
            null
          ]
        }
      }
    },
    "updated": {
      "by": "[Circular Reference]"
    }
  },
  "$meta": {
    "omitted": [
      null
    ]
  },
  "href": "text",
  "externalIds": {},
  "externalId": "text",
  "externalName": "text",
  "type": "Client",
  "status": "Active",
  "serviceLevel": "Express",
  "address": {
    "addressLine1": "text",
    "postCode": "text",
    "city": "text",
    "state": "text",
    "country": "text"
  },
  "icon": "text",
  "technicalSupportEmail": "hello@example.com",
  "website": "text",
  "description": "text",
  "name": "text",
  "groups": [
    {
      "audit": {
        "created": {
          "by": {
            "audit": {
              "created": {
                "by": "[Circular Reference]"
              },
              "updated": {
                "by": "[Circular Reference]"
              }
            },
            "$meta": {
              "omitted": [
                null
              ]
            }
          }
        },
        "updated": {
          "by": "[Circular Reference]"
        }
      },
      "$meta": {
        "omitted": [
          null
        ]
      },
      "account": "[Circular Reference]",
      "modules": "[Circular Reference]",
      "users": "[Circular Reference]",
      "buyers": "[Circular Reference]"
    }
  ]
}

post

/v1/accounts/accounts/{id}/validate

Path parameters

idstringrequired

Body

idstring

auditobject

$metaobject

hrefstring

externalIdsobject

externalIdstring | nullable

externalNamestring | nullable

typestring · enum

Options: Client, Vendor, Operations

statusstring · enum

Options: Active, Enabled, Disabled

serviceLevelstring · enum

Options: Express, Elite, Dsc, Focus, Runners, Strategics, NotApplicable

addressobject

iconstring | nullable

technicalSupportEmailstring | nullable

websitestring | nullable

descriptionstring | nullable

namestring | nullable

groupsobject[] | nullable

Responses

application/json

cURL

JavaScript

Python

HTTP

curl -L \
  --request POST \
  --url '/v1/accounts/accounts/{id}/validate' \
  --header 'Content-Type: application/json' \
  --data '{"audit":{"created":{"by":{"audit":{"created":{"by":"[Circular Reference]"},"updated":{"by":"[Circular Reference]"}},"$meta":{"omitted":[null]}}},"updated":{"by":"[Circular Reference]"}},"$meta":{"omitted":[null]},"externalIds":{},"type":"Client","status":"Active","serviceLevel":"Express","address":{"addressLine1":"text","postCode":"text","city":"text","state":"text","country":"text"},"groups":[{"audit":{"created":{"by":{"audit":{"created":{"by":"[Circular Reference]"},"updated":{"by":"[Circular Reference]"}},"$meta":{"omitted":[null]}}},"updated":{"by":"[Circular Reference]"}},"$meta":{"omitted":[null]},"account":{"audit":{"created":{"by":{"audit":{"created":{"by":"[Circular Reference]"},"updated":{"by":"[Circular Reference]"}},"$meta":{"omitted":[null]}}},"updated":{"by":"[Circular Reference]"}},"$meta":{"omitted":[null]},"externalIds":{},"type":"Client","status":"Active","serviceLevel":"Express","address":{"addressLine1":"text","postCode":"text","city":"text","state":"text","country":"text"},"name":"text","groups":[{"audit":{"created":{"by":{"audit":{"created":{"by":"[Circular Reference]"},"updated":{"by":"[Circular Reference]"}},"$meta":{"omitted":[null]}}},"updated":{"by":"[Circular Reference]"}},"$meta":{"omitted":[null]},"account":"[Circular Reference]","modules":"[Circular Reference]","users":"[Circular Reference]","buyers":"[Circular Reference]"}]},"modules":[{"audit":{"created":{"by":{"audit":{"created":{"by":"[Circular Reference]"},"updated":{"by":"[Circular Reference]"}},"$meta":{"omitted":[null]}}},"updated":{"by":"[Circular Reference]"}},"$meta":{"omitted":[null]},"filters":{"group.buyers":[null]},"settings":{"type":[null]},"accountTypes":[null]}],"users":[{"audit":{"created":"[Circular Reference]","updated":"[Circular Reference]"},"$meta":{"omitted":[null]},"phone":{},"settings":{},"currentAccount":{"audit":{"created":{"by":{"audit":{"created":{"by":"[Circular Reference]"},"updated":{"by":"[Circular Reference]"}},"$meta":{"omitted":[null]}}},"updated":{"by":"[Circular Reference]"}},"$meta":{"omitted":[null]},"externalIds":{},"type":"Client","status":"Active","serviceLevel":"Express","address":{"addressLine1":"text","postCode":"text","city":"text","state":"text","country":"text"},"name":"text","groups":"[Circular Reference]"},"accounts":["[Circular Reference]"]}],"buyers":[{"audit":{"created":"[Circular Reference]","updated":"[Circular Reference]","activated":"[Circular Reference]","unassigned":"[Circular Reference]"},"$meta":{"omitted":[null]},"contact":{"phone":{},"user":"[Circular Reference]"},"externalIds":{},"status":"Active","address":{"addressLine1":"text","postCode":"text","city":"text","state":"text","country":"text"},"account":{"audit":{"created":{"by":{"audit":{"created":{"by":"[Circular Reference]"},"updated":{"by":"[Circular Reference]"}},"$meta":{"omitted":[null]}}},"updated":{"by":"[Circular Reference]"}},"$meta":{"omitted":[null]},"externalIds":{},"type":"Client","status":"Active","serviceLevel":"Express","address":{"addressLine1":"text","postCode":"text","city":"text","state":"text","country":"text"},"name":"text","groups":"[Circular Reference]"},"errors":[{"message":"text"}],"sellers":["[Circular Reference]"]}]}]}'

200

400

{
  "id": "text",
  "audit": {
    "created": {
      "by": {
        "audit": {
          "created": {
            "by": "[Circular Reference]"
          },
          "updated": {
            "by": "[Circular Reference]"
          }
        },
        "$meta": {
          "omitted": [
            null
          ]
        }
      }
    },
    "updated": {
      "by": "[Circular Reference]"
    }
  },
  "$meta": {
    "omitted": [
      null
    ]
  },
  "href": "text",
  "externalIds": {},
  "externalId": "text",
  "externalName": "text",
  "type": "Client",
  "status": "Active",
  "serviceLevel": "Express",
  "address": {
    "addressLine1": "text",
    "postCode": "text",
    "city": "text",
    "state": "text",
    "country": "text"
  },
  "icon": "text",
  "technicalSupportEmail": "hello@example.com",
  "website": "text",
  "description": "text",
  "name": "text",
  "groups": [
    {
      "audit": {
        "created": {
          "by": {
            "audit": {
              "created": {
                "by": "[Circular Reference]"
              },
              "updated": {
                "by": "[Circular Reference]"
              }
            },
            "$meta": {
              "omitted": [
                null
              ]
            }
          }
        },
        "updated": {
          "by": "[Circular Reference]"
        }
      },
      "$meta": {
        "omitted": [
          null
        ]
      },
      "account": "[Circular Reference]",
      "modules": "[Circular Reference]",
      "users": "[Circular Reference]",
      "buyers": "[Circular Reference]"
    }
  ]
}