Uploads

Create a new bulk upload session

Creates an Upload record. Requires scope uploads:write.

post/api/v1/uploads

Request

  • Base URL: https://getscaleforge.com
  • URL: https://getscaleforge.com/api/v1/uploads
  • Auth: HTTP bearer

Request body

namestring required
template_idinteger required
meta_account_idinteger

Ad Account ID for single-account uploads

multi_accountboolean

Fan-out across all user ad accounts

creative_idsinteger[]

Example request

{
  "name": "Dec promo batch",
  "template_id": 12,
  "meta_account_id": 7,
  "creative_ids": [
    301,
    302,
    303
  ]
}

Response

Upload created

Example response

{
  "data": {
    "id": 91,
    "name": "Dec promo batch",
    "status": "processing",
    "total_campaigns": 25,
    "completed_campaigns": 18,
    "failed_campaigns": 1
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.