---
title: "Create a new Redfast tenant"
method: POST
path: "/v1/tenants"
tags: ["Tenants"]
---

# Create a new Redfast tenant

`POST /v1/tenants`

Creates a new tenant on the Redfast platform.

## Headers

- `rf-secret` string, required

## Request body

- object
  - `company_name` string, required
  - `external_tenant_id` string, required
  - `app_name` string, required
  - `app_domain` string, required
  - `user_email` string, email, required
  - `user_first_name` string, required
  - `user_last_name` string, required
  - `partner_code` string, required
  - `api_key` string, required

## Response `200`

Tenant provision started successfully

- object
  - `success` boolean
  - `status` string
  - `external_tenant_id` string
  - `app_id` string
  - `tag_url` string, uri
  - `test_mode` boolean

## Other responses

- `401` — Unauthorized - Shared secret is incorrect
- `404` — Not Found - Requested resource was not found
- `409` — Conflict - Tenant has already been provisioned
- `422` — Unprocessable Entity - Invalid or missing information

---

[API](https://skmtc.net/recurly/apis/custom-rendering-api.md) · [All operations](https://skmtc.net/recurly/apis/custom-rendering-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/recurly/custom-rendering-api/versions/5b447fc86155/schema)