---
title: "POST /v1/setup-urls"
method: POST
path: "/v1/setup-urls"
tags: ["SSOReadyService"]
---

# POST /v1/setup-urls

`POST /v1/setup-urls`

Creates a short-lived self-serve setup URL that you can send to your customer.

 Setup URLs let your customer configure their SAML settings, SCIM settings, or both.

## Request body

- CreateSetupURLRequest
  - `organizationId` string — The organization that the setup URL is for.
  - `canManageSaml` boolean — Whether the setup URL lets the user manage SAML connections.
  - `canManageScim` boolean — Whether the setup URL lets the user manage SCIM directories.

## Response `200`

OK

- CreateSetupURLResponse
  - `url` string — The one-time, short-lived self-serve setup URL. Do not log or store this URL. Because this URL is one-time, loading it yourself means your customer will not be able to load it after you.

## Other responses

- `default` — Default error response

## Changes

- **2024-08-16** `132245ed6de0` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/ssoready/apis/ssoreadyservice-api/changes/v1/setup-urls/post.md)

---

[API](https://skmtc.dev/ssoready/apis/ssoreadyservice-api.md) · [All operations](https://skmtc.dev/ssoready/apis/ssoreadyservice-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/ssoready/ssoreadyservice-api/revisions/0827d713f08e/schema)