# Importing Third-Party Content

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.

## Notes

* 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.


## Prerequisites

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.


## Integration Steps

### 1. Export Content from Third-Party Tool

* 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.


### 2. Host Media (if needed)

* 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.


### 3. Create a Content Object via Firstup API

* Use the `POST /content` endpoint 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"
}
```

### 4. (Optional) Publish or Schedule

Set the status field to "published" to go live immediately.

Use "draft" to save for later review or scheduling.