---
title: "Accept Registration Request"
method: POST
path: "/setup/registration"
tags: ["setup"]
---

# Accept Registration Request

`POST /setup/registration`

## Request

- Base URL: `https://api-docs.upsmith.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api-docs.upsmith.com/setup/registration`
- Auth: one of:
  - API key in header `x-api-key`
  - HTTP bearer

## Headers

- `organization-id` string, nullable
- `x-user-id` string, nullable
- `timezone` string
- `x-actor-email` string, nullable
- `x-request-source` string, nullable
- `x-operation-id` string, nullable
- `x-commit-message` string, nullable
- `x-confirmation-id` string, nullable
- `x-chat-id` string, nullable

## Request body

- RegistrationRequestAccept
  - `selected_number` string, required
  - `version` string, required
  - `idempotency_key` string, uuid, required
  - `acceptance_version` 'campaign-approval-v2' | 'provider-preparation-v3', nullable

## Response `202`

Successful Response

- RegistrationRequestPublic
  - `id` string, required
  - `status` string, required
  - `accepted_at` string, date-time, required
  - `review` RegistrationReviewPublic, required
    - `provider` 'twilio' | 'telnyx', required
    - `selected_number` string, required
    - `version` string, required
    - `identity` BusinessIdentitySummaryPublic, required: The confirmed company profile as Step 4 presents it: read-only, no representatives.
      - `legal_name` string, nullable
      - `dba_name` string, nullable
      - `ein_last_four` string, nullable
      - `entity_type` string, nullable
      - `company_type` string, nullable
      - `vertical` string, nullable
      - `trades` string[], nullable
      - `phone` string, nullable
      - `street` string, nullable
      - `city` string, nullable
      - `state` string, nullable
      - `postal_code` string, nullable
      - `country` string, nullable
      - `website_url` string, nullable
      - `complete` boolean
    - `campaign` BusinessCampaignPublic, required
      - `program_name` string, nullable
      - `program_description` string, nullable
      - `use_case_categories` string[], nullable
      - `use_case_subcategories` string[], nullable
      - `sample_messages` string[], nullable
      - `expected_message_volume` string, nullable
    - `opt_in` RegistrationOptInReview, required
      - `opt_in_type` string, nullable
      - `opt_in_description` string, nullable
      - `opt_in_evidence_urls` string[], nullable
      - `message_frequency` string, nullable
      - `help_message` string, nullable
      - `stop_message` string, nullable
      - `terms_url` string, nullable
      - `privacy_url` string, nullable
    - `acceptance_version` 'campaign-approval-v2' | 'provider-preparation-v3', nullable
    - `eligible_providers` MessagingProvider[], nullable

## Other responses

- `422`: Validation Error

---

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