---
title: "Verify an SSO connection's domain"
method: POST
path: "/api/v1/organizations/{organizationId}/sso-connections/{providerId}/verify-domain"
tags: ["Single sign-on"]
---

# Verify an SSO connection's domain

`POST /api/v1/organizations/{organizationId}/sso-connections/{providerId}/verify-domain`

## Request

- Base URL: `https://app.easyscraper.com`
- URL: `https://app.easyscraper.com/api/v1/organizations/{organizationId}/sso-connections/{providerId}/verify-domain`
- Auth: API key in cookie `better-auth.session_token`

Look up the DNS TXT record that proves the organization owns the connection's domain. Once it's found, people with emails at the domain can log in through the connection. Requires the `sso: ["manage"]` permission (owners)

## Path parameters

- `organizationId` string, uuid, required
- `providerId` string, required

## Response `200`

OK

- object
  - `providerId` string, required
  - `type` 'oidc' | 'saml', required
  - `issuer` string, required
  - `domain` string, required
  - `domainVerified` boolean, required
  - `domainVerificationRecord` object, nullable, required
    - `name` string, required
    - `value` string, required
  - `serviceProvider` object, required
    - `callbackUrl` string, required
    - `entityId` string, nullable, required
    - `metadataUrl` string, nullable, required

## Other responses

- `400`: 400
- `401`: 401
- `403`: 403
- `404`: 404
- `409`: 409
- `429`: 429

## Changes

- **2026-11-02** `a12cef98c52b`: 1 breaking
  - added `subschema #1` to the response body `oneOf` list for the response status `400`
- **2026-10-31** `3e642e95991a`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/easyscraper/apis/easy-scraper-api/changes/api/v1/organizations/:organizationId/sso-connections/:providerId/verify-domain/post.md)

---

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