Creating a Tenant

Last updated: May 31st, 2019

Creating a Tenant

You will need to create and configure at least one Tenant in your account in order to create collection or payout orders and start transacting with your customers.

This tutorial offers step-by-step instructions for create a new Tenant in your Account.


In addition to familiarity with the Core Concepts, you’ll need the following:

  • An Account API Key
  • Familiar with creating an HMAC token using an API Key

Create a new Tenant

Using the Access Token acquired in Step 1, we can now create a new Tenant.


Replace the {access-token} placeholder value with the Access Token value.

curl --location --request POST "" \
  --header "Authorization: Bearer {access-token}" \
  --header "Content-Type: application/json" \
  --data "{
    \"name\": \"Test tenant\",
    \"streetAddress\": \"8 Thames Street\",
    \"extendedStreetAddress\": \"\",
    \"locality\": \"London\",
    \"region\": \"Sussex\",
    \"postCode\": \"SW1 1LA\",
    \"country\": \"UK\"


The tenantId property will be the id of your newly created Tenant.

  "tenantId": "88fdb12a-14dc-419c-b74c-422e2c25cfe7",
  "accountId": "53ca62f5-b124-447d-b593-2f7ea4fecdcc",
  "name": "Test tenant",
  "address": {
    "streetAddress": "8 Thames Street",
    "extendedStreetAddress": "",
    "locality": "London",
    "region": "Sussex",
    "postCode": "SW1 1LA",
    "country": "UK"

What’s Next?