---
title: "Provision Organization Secondary Profile"
method: POST
path: "/v2/organizations/compliance"
tags: ["organizations"]
---

# Provision Organization Secondary Profile

`POST /v2/organizations/compliance`

## Request

- Base URL: `https://api.stuut.ai` (the document declares no server; this is the origin it was published from)
- URL: `https://api.stuut.ai/v2/organizations/compliance`
- Auth: HTTP bearer

Provision Secondary Profile

Give the organization its own Twilio Secondary Customer Profile — the legal identity carrying
attestation and branding for numbers the organization holds directly. Compliance is optional at
tenant creation, and until this endpoint existed, skipping it was permanent.

Twilio review takes one to two business days. Numbers can be attached to the profile while it is
pending — they activate on approval.

## Request body

- SecondaryProfileComplianceInput: Compliance details used to create a Twilio Secondary Customer Profile. Describes a legal entity, and nothing about which of our rows owns it — the same payload provisions a profile for a business unit or for the organization itself. Not stored on our side (Twilio is the source of truth); collected fresh and passed straight to Trust Hub. Twilio accepts one or two authorized representatives.
  - `cnam_display_name` string, nullable: Caller ID name; Twilio caps it at 15 characters
  - `business_employee_count` string, nullable
  - `average_business_day_call_volume` string, nullable
  - `legal_business_name` string, required
  - `business_type` string, required
  - `business_industry` string, required
  - `registration_id_type` string: e.g. EIN (US)
  - `registration_number` string, required
  - `regions_of_operation` string[], required
  - `website` string, required
  - `street_address` string, required
  - `city` string, required
  - `region` string, required: State / province
  - `postal_code` string, required
  - `iso_country` string, required
  - `email` string, required: Contact email for the profile
  - `representatives` AuthorizedRepresentative[], required
    - `first_name` string, required
    - `last_name` string, required
    - `email` string, required
    - `phone` string, phone, required: A phone number in [E.164](https://en.wikipedia.org/wiki/E.164) format
    - `title` string, required

## Response `202`

Successful Response

- OrganizationSecondaryProfileResponse: Acknowledges that Trust Hub provisioning was enqueued; the work runs asynchronously.
  - `organization_id` string, required: The organization the profile is being provisioned for

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/stuut/apis/stuut-api.md) - [All operations](https://skmtc.dev/stuut/apis/stuut-api/llms.txt) - [OpenAPI document](https://skmtc.dev/stuut/apis/stuut-api/revisions/ff0ad16a55ff?raw)