You can use the Firstup API to import and publish content originally created in third-party design tools (e.g., Canva). This enables teams to streamline their creative workflows by designing assets externally and programmatically pushing them into Firstup as articles or posts.
- The API does not support direct binary file uploads.
- Use public URLs to embed images or videos in the body field.
- Rich HTML content and media embeds are supported within the body.
Before you begin, ensure the following:
- You have a valid Firstup API token with permissions to create content.
- You have access to a design platform that supports:
- Programmatic export of completed designs (e.g., to PNG, PDF, MP4).
- Downloadable asset URLs or access to file blobs.
- You have a method for hosting or storing the exported asset (e.g., cloud storage with public URLs) if embedding media into the post body.
- Use the external tool's export functionality to generate the desired file format (e.g., image, video, or document).
- Retrieve a public download URL or access the file as binary data.
- If your exported content is a media file (e.g., PNG or MP4), host it on a public CDN or storage bucket.
- Reference the hosted URL in the Firstup content body.
- Use the
POST /contentendpoint to create a new content item.
POST /content
Authorization: Bearer YOUR_API_TOKEN
Content-Type: application/json{
"title": "Team Update – August Edition",
"status": "draft",
"content_type": "article",
"body": "<img src='https://your-cdn.com/assets/august-update.png' alt='August Update' />",
"author_id": "your-author-id"
}Set the status field to "published" to go live immediately.
Use "draft" to save for later review or scheduling.