Create a Tenant

A tenant represents an organization’s customer when that customer is itself a platform with its own users who need to be represented in Tesser’s systems. When an organization’s customers are tenants, originators and/or beneficiaries are customers of the tenant and thus end-customers to the organization.

To create a tenant, submit a request to the tenant creation API.

Code
 
{
  "business_legal_name": "Acme Corporation",
  "business_dba": "Acme Co",
  "business_address_country": "US",
  "business_street_address1": "123 Corp Blvd",
  "business_street_address2": "Suite 100",
  "business_city": "New York",
  "business_state": "NY",
  "business_legal_entity_identifier": "123456789",
  "webhook_url": "https://acme.com/webhooks/tesser"
}

Example response:

Code
 
{
  "data": {
    "id": "29c580bd-43d2-4dbf-bc9e-a3b1ccb8e7ee",
    "workspace_id": "b53f6690-3242-4942-9907-885779632832",
    "business_legal_name": "Acme Corporation",
    "business_dba": "Acme Co",
    "business_address_country": "US",
    "business_street_address1": "123 Corp Blvd",
    "business_street_address2": "Suite 100",
    "business_city": "New York",
    "business_state": "NY",
    "business_legal_entity_identifier": "9876543210",
    "country": "US",
    "webhook_url": "https://acme.com/webhooks/tesser",
    "created_at": "2024-01-15T10:30:00.000Z",
    "updated_at": "2024-01-15T10:30:00.000Z"
  }
}

Creating resources for a tenant

To initiate counterparty, account, payment, or transfer creation on behalf of the tenant, you will supply supply the id of the tenant returned in the creation response in API calls using your own API keys.