Skip to main content
Register a portal creative that you uploaded via Get Creative Upload URL. The file must already exist in storage under an images/portal/ key. Route: POST /api/external/v1/portals/creatives/create

​
Headers

HeaderRequiredDescription
Content-TypeYesMust be application/json
x-magna-api-tokenYesYour Magna API token

​
Body parameters

FieldTypeRequiredDescription
storageKeystringYesStorage key returned by the upload-url endpoint (must start with images/portal/)
namestringYesDisplay name for the asset

​
Request example

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

{
  "id": "doc...uuid",
  "storageKey": "images/portal/hero-abc123.png",
  "publicUrl": "https://.../images/portal/hero-abc123.png"
}