---
title: "Get AuthProfile by ID"
method: GET
path: "/v1/Webhooks/AuthProfiles/{authProfileId}"
tags: ["AuthProfiles"]
---

# Get AuthProfile by ID

`GET /v1/Webhooks/AuthProfiles/{authProfileId}`

## Request

- Base URL: `https://webhooks.twilio.com`
- URL: `https://webhooks.twilio.com/v1/Webhooks/AuthProfiles/{authProfileId}`
- Auth: HTTP basic

Returns an AuthProfile resource by its ID. Secrets are never returned in GET responses.

## Response `200`

AuthProfile details (secrets NOT included)

- union: Authentication resource that can be shared across various settings
  - object: OAuth2 client credentials authentication
    - `id` string, required: Unique AuthProfile identifier (TypeID/TTID format)
    - `type` 'OAUTH2', required: Authentication type
    - `friendlyName` string, required: Human-readable name for identification
    - `createdAt` string, date-time, required
    - `updatedAt` string, date-time, required
    - `tokenUrl` string, uri, required: OAuth2 token endpoint URL
    - `clientId` string, required: OAuth2 client identifier
    - `clientSecret` string: OAuth2 client secret (never returned, stored securely as secret)
    - `scope` string: OAuth2 scope to request
    - `audience` string, nullable: OAuth2 audience parameter
    - `clientCredentialsAuthMethod` 'CLIENT_SECRET_POST' | 'CLIENT_SECRET_BASIC': Client credentials authentication method (defaults to CLIENT_SECRET_POST)
  - object: HTTP Basic authentication
    - `id` string, required: Unique AuthProfile identifier (TypeID/TTID format)
    - `type` 'BASIC', required: Authentication type
    - `friendlyName` string, required: Human-readable name for identification
    - `createdAt` string, date-time, required
    - `updatedAt` string, date-time, required
    - `username` string, required: Basic auth username
    - `password` string: Basic auth password (never returned, stored securely as secret)
  - object: HTTP Digest authentication
    - `id` string, required: Unique AuthProfile identifier (TypeID/TTID format)
    - `type` 'DIGEST', required: Authentication type
    - `friendlyName` string, required: Human-readable name for identification
    - `createdAt` string, date-time, required
    - `updatedAt` string, date-time, required
    - `username` string, required: Digest auth username
    - `password` string: Digest auth password (never returned, stored securely as secret)

## Other responses

- `401`: Authentication failed
- `403`: Authenticated account does not have permission to perform this operation
- `404`: AuthProfile not found or deleted
- `429`: Rate limit exceeded
- `500`: An unexpected server error occurred

---

[API](https://skmtc.dev/twilio/apis/webhooks-v1.md) - [All operations](https://skmtc.dev/twilio/apis/webhooks-v1/llms.txt) - [OpenAPI document](https://skmtc.dev/twilio/apis/webhooks-v1/revisions/629b4cc3a029?raw)
