MCP tool · Creatives
import_link
Imports the creatives behind a Frame.io, Dropbox or Google Drive link (a file or a folder) through the account connected to Apogee. A public Frame.io share works without a Frame.io account when downloads are allowed; a password-protected share does not.
What it does
Import the creatives behind a link into Apogee: Frame.io (project, folder or file address as next.frame.io shows it, or a legacy app.frame.io asset, through the Frame.io account connected to Apogee), Dropbox (shared file or folder) or Google Drive (file or folder).
A public Frame.io share link (f.io/..., next.frame.io/share/...) works too, without any Frame.io account, when the sender left downloads on: reading it takes 20 to 30 s. A password-protected share is not supported: ask for the files instead.
Returns import jobs (the first 200 files of a link at most: truncated says when there were more; they count in the day's upload budget); call import_status until every job is COMPLETED, then pass each job's ref in prepare_launch files.
Parameters
-
urlstring required
Example
Your assistant calls it for you when you ask in your own words. What it sends (MCP tools/call, JSON-RPC 2.0):
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "import_link",
"arguments": {
"url": "https://www.dropbox.com/scl/fo/example0000/nordlicht-creatives"
}
}
}The same call over HTTP with an API key, for an MCP client of your own (an assistant that signs in sends its OAuth token instead):
curl -X POST https://app.apogee.ad/mcp \
-H "Authorization: Bearer $APOGEE_API_KEY" \
-H "Content-Type: application/json" \
-H "Accept: application/json, text/event-stream" \
-d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"import_link","arguments":{"url":"https://www.dropbox.com/scl/fo/example0000/nordlicht-creatives"}}}'Access and cost
| Plans | Pro and Scale. |
|---|---|
| Scope | launch: a connection or an API key without it does not see this tool (scopes). |
| Effect | Changes Apogee only (imports, uploads, settings, comment syncs, AI drafts): nothing on the ad account. |
| Credits | Free up to the daily free reads (5,000 a day on Pro, 10,000 on Scale), then 1 credit per read. A call that fails costs nothing (credits). |
| Rate limit | 600 MCP requests per 15 minutes on Pro, 1,200 on Scale (rate limits). |
| Daily cap | Counts 2 units toward the 2,000 units one API key or assistant connection can use in 24 hours. |
In the REST API
The same thing for your own code, with an API key:
- Create import:
POST /imports
Related tools
Creatives: Bring the files in before a launch. Nothing reaches Meta at this point.
import_status: The progress of an import. Each finished file gets areffor the launch.list_drive_folder: The videos and images of a Google Drive folder, subfolders included, each with its format.get_upload_urls: For files on your computer: one signed upload URL per file (50 per call, 500 MB per file, valid 1 hour). The assistant uploads each file with an HTTPPUT.confirm_uploads: Checks each uploaded file arrived and is not empty.