---
title: "Create a profile"
method: POST
path: "/api/v1/profiles"
tags: ["Profiles"]
---

# Create a profile

`POST /api/v1/profiles`

## Request

- Base URL: `https://app.tryadeli.com`
- URL: `https://app.tryadeli.com/api/v1/profiles`
- Auth: HTTP bearer

Send an `Idempotency-Key` header to make retries safe.

## Headers

- `Idempotency-Key` string

## Request body

- object
  - `name` string, required
  - `externalId` string, nullable
  - `metadata` object, nullable

## Response `201`

Success

- object
  - `id` string, uuid, required
  - `name` string, required
  - `externalId` string, nullable, required
  - `metadata` object, nullable, required
  - `isDefault` boolean, required
  - `createdAt` string, date-time, required
  - `updatedAt` string, date-time, required

## Other responses

- `400`: Invalid request or provider failure
- `401`: Missing or invalid API key
- `404`: Profile, account, or object not found
- `409`: The request conflicts with existing state
- `502`: Invalid request or provider failure

## Changes

- **2026-10-20** `7a149f5a838a`: 11 info
  - added the new optional `header` request parameter `Idempotency-Key`
  - added the non-success response with the status `409`
  - removed the non-success response with the status `403`
  - removed the non-success response with the status `422`
  - …7 more

[Operation history](https://skmtc.dev/tryadeli/apis/adeli-api/changes/api/v1/profiles/post.md)

---

[API](https://skmtc.dev/tryadeli/apis/adeli-api.md) · [All operations](https://skmtc.dev/tryadeli/apis/adeli-api/llms.txt) · [OpenAPI document](https://skmtc.dev/tryadeli/apis/adeli-api/revisions/7a149f5a838a?raw)