> ## Documentation Index
> Fetch the complete documentation index at: https://developers.argosidentity.com/llms.txt
> Use this file to discover all available pages before exploring further.

# POST /profiles

> Create a new profile under a workflow.

## Endpoint

```
POST /v1/workflows/{workflowId}/profiles
```

## Request

```bash theme={null}
curl -X POST "http://client-omni-api.argosidentity.com/v1/workflows/{workflowId}/profiles" \
  -H "x-api-key: your-api-key-here" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Acme Corp - KYB Verification",
    "description": "KYB verification for Acme Corp",
    "metadata": {
      "region": "KR",
      "riskProfile": "standard"
    }
  }'
```

### Request Body

<ResponseField name="name" type="string" required>
  Display name for the profile (max 255 characters)
</ResponseField>

<ResponseField name="description" type="string">
  Profile description
</ResponseField>

<ResponseField name="metadata" type="object">
  Optional custom metadata (key-value pairs)
</ResponseField>

## Response (201 Created)

```json theme={null}
{
  "id": "pf_a1b2c3d4",
  "workflowId": "wf_7a3f9c2e",
  "name": "Acme Corp - KYB Verification",
  "description": "KYB verification for Acme Corp",
  "metadata": {
    "region": "KR",
    "riskProfile": "standard"
  },
  "itemsCount": 0,
  "lastAnalysisAt": null,
  "folders": [
    {
      "id": "fld_default001",
      "name": "default",
      "isDefault": true,
      "itemsCount": 0,
      "createdAt": "2026-03-15T10:00:00Z"
    }
  ],
  "createdAt": "2026-03-15T10:00:00Z",
  "updatedAt": "2026-03-15T10:00:00Z"
}
```

<Note>
  A **default folder** is automatically created with each new profile. You can upload items directly to this folder or create additional folders.
</Note>