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

# Create Creative

> Register an uploaded portal asset so it can be referenced in portal configuration.

Register a portal creative that you uploaded via
[Get Creative Upload URL](/apis/admin/portals/creative-upload-url). The file must
already exist in storage under an `images/portal/` key.

**Route:** `POST /api/external/v1/portals/creatives/create`

## Headers

| Header              | Required | Description                |
| ------------------- | -------- | -------------------------- |
| `Content-Type`      | Yes      | Must be `application/json` |
| `x-magna-api-token` | Yes      | Your Magna API token       |

## Body parameters

| Field        | Type   | Required | Description                                                                        |
| ------------ | ------ | -------- | ---------------------------------------------------------------------------------- |
| `storageKey` | string | Yes      | Storage key returned by the upload-url endpoint (must start with `images/portal/`) |
| `name`       | string | Yes      | Display name for the asset                                                         |

## Request example

```sh theme={null}
curl -X POST https://app.magna.so/api/external/v1/portals/creatives/create \
-H 'Content-Type: application/json' \
-H 'x-magna-api-token: YOUR_API_KEY' \
-d '{
  "storageKey": "images/portal/hero-abc123.png",
  "name": "Hero image"
}'
```

## Response example

```json theme={null}
{
  "id": "doc...uuid",
  "storageKey": "images/portal/hero-abc123.png",
  "publicUrl": "https://.../images/portal/hero-abc123.png"
}
```