---
title: "List setup links"
method: GET
path: "/customers/{customer_id}/setup_links"
tags: ["Setup Links"]
---

# List setup links

`GET /customers/{customer_id}/setup_links`

Get WhatsApp onboarding links for a customer, most recent first.

## Query parameters

- `status` 'active' | 'used' | 'expired' | 'revoked'
- `created_after` string, date-time
- `created_before` string, date-time
- `per_page` integer
- `page` integer

## Response `200`

Success

- SetupLinkListResponse
  - `data` SetupLink[], required
    - `id` string, uuid, required
    - `status` 'active' | 'used' | 'expired' | 'revoked', required
    - `created_at` string, date-time, required
    - `expires_at` string, date-time, nullable — Expires 30 days after creation by default
    - `url` string, uri, required
    - `success_redirect_url` string, uri, nullable
    - `failure_redirect_url` string, uri, nullable
    - `allowed_connection_types` string[] — `coexistence` - Use with WhatsApp Business App (5 msg/sec) `dedicated` - API-only through Kapso (up to 1000 msg/sec) Provide one value to auto-select for customer
    - `meta_billing_mode` 'customer_managed' | 'partner_managed', required — Policy selected when the setup link was created. `customer_managed` uses the WABA's Meta payment method. `partner_managed` requests Kapso billing for the entire WABA after Meta returns the connected account.
    - `theme_config` object, nullable — Hex colors for hosted onboarding page
      - `primary_color` string — Primary action buttons (default
      - `primary_foreground_color` string — Text on primary buttons (default
      - `background_color` string — Page background (default
      - `text_color` string — Body text (default
      - `muted_text_color` string — Secondary text (default
      - `card_color` string — Card backgrounds (defaults to background_color)
      - `muted_color` string — Disabled elements (default
      - `border_color` string — Borders and dividers (default
      - `secondary_color` string — Secondary buttons (default
      - `secondary_foreground_color` string — Text on secondary buttons (default
      - `destructive_color` string — Error/danger buttons (default
      - `destructive_foreground_color` string — Text on destructive buttons (default
    - `provision_phone_number` boolean, nullable — Auto-provision number during onboarding
    - `phone_number_area_code` string, nullable — US area code for provisioned numbers
    - `phone_number_country_isos` string[] — Allowed countries for provisioning (defaults to ["US"])
    - `reconnect_phone_number` string, nullable — Normalized E.164 digits of the customer's existing WhatsApp number this link is targeting for reconnect. Set this on create to scope the setup flow to a specific existing WhatsApp config for the same customer (token refresh / re-auth). When present, `provision_phone_number` is forced to `false` and `allowed_connection_types` is locked to match the existing config (`["dedicated"]` or `["coexistence"]`).
    - `language` 'en' | 'es' | 'pt' | 'hi' | 'id' | 'ar' | 'null', nullable — ISO 639-1 language code for setup link UI (en, es, pt, hi, id, ar). Defaults to user's browser language.
    - `whatsapp_setup_status` 'pending' | 'processing' | 'completed' | 'failed'
    - `whatsapp_setup_error` string, nullable
    - `provisioned_phone_number` PhoneNumberReference
      - `id` string, uuid, required
      - `phone_number` string, required
      - `status` string, required
      - `area_code` string, nullable
      - `country_iso` string, required
      - `country_dial_code` string, required
      - `display_number` string, nullable
  - `meta` PaginationMeta, required
    - `page` integer, required
    - `per_page` integer, required
    - `total_pages` integer, required
    - `total_count` integer, required

## Other responses

- `401` — Missing or invalid API key
- `404` — Resource not found

---

[API](https://skmtc.net/kapso/apis/kapso-platform-api.md) · [All operations](https://skmtc.net/kapso/apis/kapso-platform-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/kapso/kapso-platform-api/revisions/18ff5548a33f/schema)