Get help on how to use the API with external tools

Do you use tools like n8n, Make, Zapier, or Postman to schedule posts or automate tasks with Metricool’s API? Here we answer the most common questions and typical API setup errors.

❓ FAQs

Where should I place the authentication token?

In all cases, your Metricool account token must be included in the header as:

X-Mc-Auth: YOUR API TOKEN

You must also include:

Content-Type: application/json

⚠️ ​Make sure your request includes both blogId and userId parameters.

📋 Tool summary table

How do I get my blogId?

You have two options:

1. From the Metricool URL

When you access a brand in your account, you'll see a URL like this. You should copy the number that comes after blogId, which identifies each brand. (The number after userId identifies your account.)

https://app.metricool.com/evolution/web?blogId=00000&userId=0000000

2. Via API:

You can make a call to this endpoint. It returns a list of all the brands you manage or that have been shared with you. Each entry includes its corresponding blogId:

https://app.metricool.com/api/admin/simpleProfiles?userId=YOUR_USER_ID

What format should the publicationDate use?

Use ISO 8601, including timezone. Example:

"publicationDate": {
"dateTime": "2025-07-23T10:00:00",
"timezone": "Europe/Madrid"
}

Can I upload images or videos via the API?

Yes. First, you need to upload the media to Metricool and get a mediaId, then reference it in your post. Make sure your media links are public and do not expire. We also recommend making a call to the normalize endpoint to ensure the file is hosted on Metricool’s servers.

Can I use the API with tools not listed above?

Yes. Any tool that allows HTTP requests with custom headers can be integrated with Metricool’s API.

⚠️ Common errors (and how to fix them)

Access denied (or similar)

This error means the token is not being sent correctly or does not have access to the brand (blog) you're trying to post to.

✅ Fix

• Double-check you’re using the correct token from your Metricool account.
• Make sure it’s placed exactly as shown in the table above.
• Confirm the blogId and userId belong to your account.

🔎 n8n example:

The post is scheduled but has no image or video

This means the media wasn't properly handled before sending the API request.

✅ Fix

1. Make sure the media link is public and doesn’t expire. Private or temporary URLs will be skipped.
2. Ensure you're including the mediaId in your post. If not, the post will be scheduled without media.
3. Before calling https://app.metricool.com/api/v2/scheduler/posts, normalize the media URL by making a GET request to:

https://app.metricool.com/api/actions/normalize/image/url?url=<URL_OF_YOUR_MEDIA>

This ensures the file is hosted on Metricool servers if needed and returns a valid URL that can be turned into a mediaId.

4. Use the returned mediaId in your post like this:

"media": {
"mediaId": "ID_OF_MEDIA"
}

Updated on: 30/07/2025