API Reference

You can interact with the Mixpost API through HTTP requests from any language. Note that only Mixpost Pro/Enterprise v2 supports the API.

Create Access Token

Creating an access token is a straightforward process that grants applications or scripts the ability to interact with your account. Here's a step-by-step guide to creating an access token:

  1. Locate the User Menu:

    • Begin by navigating to the bottom left corner of the dashboard where you will find the user menu. This is typically represented by your avatar.
  2. Access the "Access Tokens" Page:

    • Within the user menu, look for a menu item labeled "Access Tokens" and click on it. This will take you to the page where you can manage or create new access tokens.
  3. Open Token Creation form:

    • On the "Access Tokens" page, find the "Create Token" button and click on it to start the process of creating a new access token.
  4. Configure Your Token:

    • You will be prompted to enter a name for your new access token. Choose a name that is descriptive and helps you remember the purpose of the token.
    • Next, set the expiration for the token if this option is available. The expiration is the date until which the token will remain valid. Depending on your needs, you might set it to never expire or to expire after a certain period.
  5. Copy Your New Access Token:

    • After creating the token, it will be displayed on the screen. It is crucial to copy this token and keep it in a safe place, as it will not be shown again. If you lose this token, you may need to revoke it and create a new one.
    • Ensure you copy the token completely and store it securely. Treat it as sensitively as you would your password, as it grants access to your account.

Screenshots

1-access-token.png

2-access-token.png

3-access-token.png

4-access-token.png

Conclusion

Once you have the token, you can make authorized HTTP requests to the API. To do this, you include the token in the HTTP request header using the Authorization field with the Bearer scheme. Here is an example of what the header might look like:

Authorization: Bearer YOUR_ACCESS_TOKEN_HERE

If the token is invalid or expired, the server will respond with a 401 Unauthorized status code.

The general format for API endpoints within Mixpost is as follows:

/{yourCorePath}/api/*

Important Reminder: The access token acts as a key to your account for the specific purposes you've generated it for. It's essential to keep it secure and only share it with trusted applications or services. If you suspect that your access token has been compromised, you should revoke it immediately and generate a new one.

Accounts

[GET] List accounts

Method: GET
Endpoint: /{yourCorePath}/api/{workspaceUuid}/accounts
Authorization
: Bearer
Response:

{
  "data": [
    {
      "id": 6,
      "uuid": "123e4567-e89b-12d3-a456-426614174000",
      "name": "Dima Botezatu",
      "username": "lao9s",
      "image": "https://example.com/avatar/dima.jpg",
      "provider": "instagram",
      "data": {},
      "authorized": true,
      "created_at": "2024-03-30 10:00:00"
    },
    {
      "id": 5,
      "uuid": "7eafa7f6-51d7-4597-a775-702a9b8bd884",
      "name": "Dima Botezatu",
      "username": "lao9s",
      "image": "https://example.com/avatar/dima.jpg",
      "provider": "tiktok",
      "data": {
        "union_id": "14754564",
        "is_private": false,
        "duet_disabled": false,
        "privacy_levels": [
          "PUBLIC_TO_EVERYONE",
          "MUTUAL_FOLLOW_FRIENDS",
          "SELF_ONLY"
        ],
        "stitch_disabled": false,
        "comment_disabled": false,
        "max_video_post_duration_sec": 600
      },
      "authorized": true,
      "created_at": "2024-03-29 14:47:32"
    },
    {
      "id": 4,
      "uuid": "aa4d3505-05c9-401f-9b8d-9a633b82c768",
      "name": "Dima Botezatu",
      "username": "lao9s",
      "image": "https://example.com/avatar/dimap.jpg",
      "provider": "pinterest",
      "data": {
        "relationships": {
          "boards": [
            {
              "id": "176378040495433160",
              "name": "Local"
            }
          ]
        }
      },
      "authorized": true,
      "created_at": "2024-03-29 14:42:37"
    },
    {
      "id": 3,
      "uuid": "ed1d7f93-ebca-4217-957c-a25fbb2c1075",
      "name": "Dima Botezatu",
      "username": "BotezatuDima",
      "image": "https://example.com/avatar/dima.jpg",
      "provider": "twitter",
      "data": null,
      "authorized": true,
      "created_at": "2024-03-29 09:55:31"
    },
    {
      "id": 2,
      "uuid": "cfbdc3eb-22cb-4d15-b2a0-63d5fcd5bd92",
      "name": "Dima Botezatu",
      "username": "dimabotezatu",
      "image": null,
      "provider": "linkedin",
      "data": null,
      "authorized": true,
      "created_at": "2024-03-29 09:49:22"
    },
    {
      "id": 1,
      "uuid": "85347d5e-9724-4cb6-b91c-82d6d6d4e992",
      "name": "Mixpost",
      "username": "getmixpost",
      "image": "https://example.com/avatar/mixpost.jpg",
      "provider": "facebook_page",
      "data": {
        "suffix": {
          "value": "Page",
          "edited": false
        }
      },
      "authorized": true,
      "created_at": "2024-03-27 11:30:45"
    },
  ]
}
[GET] Get an account

Method: GET
Endpoint: /{yourCorePath}/api/{workspaceUuid}/accounts/{accountUuid}
Authorization
: Bearer
Response:

{
  "id": 1,
  "uuid": "85347d5e-9724-4cb6-b91c-82d6d6d4e992",
  "name": "Mixpost",
  "username": "getmixpost",
  "image": "https://example.com/avatar/mixpost.jpg",
  "provider": "facebook_page",
  "data": {
    "suffix": {
      "value": "Page",
      "edited": false
    }
  },
  "authorized": true,
  "created_at": "2024-03-27 11:30:45"
},

Media Files

[GET] List media files

Method: GET
Endpoint: /{yourCorePath}/api/{workspaceUuid}/media?page=1
Authorization
: Bearer
Response:

{
  "data": [
      {
          "id": "2",
          "uuid": "161b8c2d-c424-3a6a-b554-be277418ff08",
          "name": "tea-reduced-file-size.mp4",
          "mime_type": "video/mp4",
          "type": "video",
          "url": "https://your-domain.com/storage/2576cb55-ab0f-3708-9388-6d03290fcb3f/uploads/03-2024/9LD3AR2JF6MHl79rG7qWxGdEiqzneaOxMcnuw1M7.mp4",
          "thumb_url": "https://your-domain.com/storage/2576cb55-ab0f-3708-9388-6d03290fcb3f/uploads/03-2024/9LD3AR2JF6MHl79rG7qWxGdEiqzneaOxMcnuw1M7-thumb.jpg",
          "is_video": true,
          "created_at": "2024-03-29 15:33:32"
      },
      {
          "id": "1",
          "uuid": "511b8c2d-c424-3a6a-a154-be271418ff01",
          "name": "blue.png",
          "mime_type": "image/png",
          "type": "image",
          "url": "https://your-domain.com/storage/2576cb55-ab0f-3708-9388-6d03290fcb3f/uploads/03-2024/HsqEvFqHQYEU14DARrqULDnvoh7GMYopQGqYGhoi.png",
          "thumb_url": "https://your-domain.com/storage/2576cb55-ab0f-3708-9388-6d03290fcb3f/uploads/03-2024/HsqEvFqHQYEU14DARrqULDnvoh7GMYopQGqYGhoi-thumb.png",
          "is_video": false,
          "created_at": "2024-03-29 15:33:23"
      }
  ],
  "links": {
      "first": "https://your-domain.com/your-core-path/api/2576cb55-ab0f-3708-9388-6d03290fcb3f/media?page=1",
      "last": "https://your-domain.com/your-core-path/api/2576cb55-ab0f-3708-9388-6d03290fcb3f/media?page=1",
      "prev": null,
      "next": null
  },
  "meta": {
      "current_page": 1,
      "from": 1,
      "last_page": 1,
      "links": [
          {
              "url": null,
              "label": "« Previous",
              "active": false
          },
          {
              "url": "https://your-domain.com/your-core-path/api/2576cb55-ab0f-3708-9388-6d03290fcb3f/media?page=1",
              "label": "1",
              "active": true
          },
          {
              "url": null,
              "label": "Next »",
              "active": false
          }
      ],
      "path": "https://your-domain.com/your-core-path/api/2576cb55-ab0f-3708-9388-6d03290fcb3f/media",
      "per_page": 20,
      "to": 2,
      "total": 2
  }
}
[GET] Get a media file

Method: GET
Endpoint: /{yourCorePath}/api/{workspaceUuid}/media/{mediaUuid}
Authorization
: Bearer
Response:

{
  "id": "1",
  "uuid": "511b8c2d-c424-3a6a-a154-be271418ff01",
  "name": "blue.png",
  "mime_type": "image/png",
  "type": "image",
  "url": "https://your-domain.com/storage/2576cb55-ab0f-3708-9388-6d03290fcb3f/uploads/03-2024/HsqEvFqHQYEU14DARrqULDnvoh7GMYopQGqYGhoi.png",
  "thumb_url": "https://your-domain.com/storage/2576cb55-ab0f-3708-9388-6d03290fcb3f/uploads/03-2024/HsqEvFqHQYEU14DARrqULDnvoh7GMYopQGqYGhoi-thumb.png",
  "is_video": false,
  "created_at": "2024-03-29 15:33:23"
}
[POST] Upload a media file

MethodPOST
Endpoint: /{yourCorePath}/api/{workspaceUuid}/media
Authorization
: Bearer
Body:

{
  "file": binary,
}
Key Format Required Description
file binary required

File binary.

[DEL] Delete media files

MethodDELETE
Endpoint: /{yourCorePath}/api/{workspaceUuid}/media
Authorization
: Bearer
Params:

{
  "items": [1,2]
}
Key Format Required Description
items array required Array of media file IDs
items.* integer required Media File ID

Tags

[GET] List tags

Method: GET
Endpoint: /{yourCorePath}/api/{workspaceUuid}/tags
Authorization
: Bearer
Response:

{
    "data": [
        {
            "id": 3,
            "uuid": "a09367a5-dfc1-43d7-9557-70eb93e01e01",
            "name": "news",
            "hex_color": "#38bdf8"
        },
        {
            "id": 2,
            "uuid": "f9288040-0d50-4e40-83d6-10ef6dd31d9d",
            "name": "release",
            "hex_color": "#111827"
        },
        {
            "id": 1,
            "uuid": "2323e1eb-b3a6-4183-990d-4d5afea04835",
            "name": "motivation",
            "hex_color": "#60a5fa"
        }
    ]
}
[GET] Get a tag

Method: GET
Endpoint: /{yourCorePath}/api/{workspaceUuid}/tags/{tagUuid}
Authorization
: Bearer
Response:

{
  "id": 1,
  "uuid": "2323e1eb-b3a6-4183-990d-4d5afea04835",
  "name": "motivation",
  "hex_color": "#60a5fa"
}
[POST] Create a tag

MethodPOST
Endpoint: /{yourCorePath}/api/{workspaceUuid}/tags
Authorization
: Bearer
Body:

{
  "name": "motivation",
  "hex_color": "#60a5fa"
}
[DEL] Delete a tag

Method: DEL
Endpoint: /{yourCorePath}/api/{workspaceUuid}/tags/{tagUuid}
Authorization
: Bearer

Posts

[GET] List posts

Method: GET
Endpoint: /{yourCorePath}/api/{workspaceUuid}/posts?page=1
Authorization
: Bearer
Response:

{
  "data": [
    {
      "id: 3,
      "uuid": "8eb4e98d-2b93-44bd-a664-7a6438eff67b",
      "status": "draft",
      "accounts": [],
  "versions": [
    {
      "account_id": 0,
      "is_original": true,
      "content": [
        {
          "body": "",
          "media": [],
          "url": ""
        }
      ],
      "options": {
        "tiktok": {
          "privacy_level": {
            "account-0": null
          },
          "allow_comments": {
            "account-0": false
          },
          "allow_duet": {
            "account-0": false
          },
          "allow_stitch": {
            "account-0": false
          },
          "content_disclosure": {
            "account-0": false
          },
          "brand_organic_toggle": {
            "account-0": false
          },
          "brand_content_toggle": {
            "account-0": false
          },
        },
        "youtube": {
          "title": null,
          "status": "public"
        },
        "linkedin": {
          "visibility": "PUBLIC"
        },
        "mastodon": {
          "sensitive": false
        },
        "instagram": {
          "type": "post"
        },
        "pinterest": {
          "title": null,
          "link": null,
          "boards": {
            "account-0": null
          }
        },
        "facebook_page": {
          "type": "post"
        }
      }
    }
  ],
  "tags": [
    {
      "id": 2,
      "uuid": "f9288040-0d50-4e40-83d6-10ef6dd31d9d",
      "name": "release",
      "hex_color": "#111827"
    },
    {
      "id": 3,
      "uuid": "a09367a5-dfc1-43d7-9557-70eb93e01e01",
      "name": "news",
      "hex_color": "#38bdf8"
    }
  ],
  "user": {
    "name": "Test User"
  },
  "scheduled_at": null,
  "published_at": null,
  "created_at": "2024-03-29 15:26:06",
  "trashed": false
},
{
  "id: 2,
  "uuid": "69288ffd-d4ef-4666-9320-4b9e120694fc",
  "status": "published",
  "accounts": [
  {
  "id": 3,
  "uuid": "ed1d7f93-ebca-4217-957c-a25fbb2c1075",
  "name": "Dima Botezatu",
  "username": "BotezatuDima",
  "image": "https://example.com/avatar/dima.jpg",
  "provider": "twitter",
  "data": null,
  "authorized": true,
  "created_at": "2024-03-29 09:55:31",
  "external_url": "https://twitter.com/BotezatuDima/status/23424241115453465",
  "errors": []
}
],
"versions": [
  {
    "account_id": 0,
    "is_original": true,
    "content": [
      {
        "body": "<div>Create your dream SaaS easily with Mixpost! 💻✨</div>",
        "media": [
          {
            "id": "1",
            "name": "blue.png",
            "mime_type": "image/png",
            "type": "image",
            "url": "https://your-domain.com/storage/2576cb55-ab0f-3708-9388-6d03290fcb3f/uploads/03-2024/HsqEvFqHQYEU14DARrqULDnvoh7GMYopQGqYGhoi.png",
            "thumb_url": "https://your-domain.com/storage/2576cb55-ab0f-3708-9388-6d03290fcb3f/uploads/03-2024/HsqEvFqHQYEU14DARrqULDnvoh7GMYopQGqYGhoi-thumb.png",
            "is_video": false,
            "created_at": "2024-03-29 15:33:23"
          }
        ],
        "url": ""
      }
    ],
    "options": {
      "tiktok": {
        "privacy_level": {
          "account-0": null
        },
        "allow_comments": {
          "account-0": false
        },
        "allow_duet": {
          "account-0": false
        },
        "allow_stitch": {
          "account-0": false
        },
        "content_disclosure": {
          "account-0": false
        },
        "brand_organic_toggle": {
          "account-0": false
        },
        "brand_content_toggle": {
          "account-0": false
        },
      },
      "youtube": {
        "title": null,
        "status": "public"
      },
      "linkedin": {
        "visibility": "PUBLIC"
      },
      "mastodon": {
        "sensitive": false
      },
      "instagram": {
        "type": "post"
      },
      "pinterest": {
        "title": null,
        "link": null,
        "boards": {
          "account-0": null
        }
      },
      "facebook_page": {
        "type": "post"
      }
    }
  }
],
"tags": [],
"user": {
  "name": "Dima Botezatu"
},
"scheduled_at": "2024-03-29 09:55:57",
"published_at": "2024-03-29 09:56:03",
"created_at": "2024-03-29 09:55:34",
"trashed": false
},
{
  "id: 1,
  "uuid": "b1b06706-ef95-42b7-8ac8-d648dc9a9d65",
  "status": "published",
  "accounts": [
  {
  "id": 2,
  "uuid": "cfbdc3eb-22cb-4d15-b2a0-63d5fcd5bd92",
  "name": "Dima Botezatu",
  "username": "dimabotezatu",
  "image": null,
  "provider": "linkedin",
  "data": null,
  "authorized": true,
  "created_at": "2024-03-29 09:49:22",
  "external_url": "https://linkedin.com/feed/update/urn:li:share:43536647554322",
  "errors": []
},
{
  "id": 1,
  "uuid": "85347d5e-9724-4cb6-b91c-82d6d6d4e992",
  "name": "Mixpost",
  "username": "getmixpost",
  "image": "https://example.com/avatar/mixpost.jpg",
  "provider": "facebook_page",
  "data": {
    "suffix": {
      "value": "Page",
      "edited": false
    }
  },
  "authorized": true,
  "created_at": "2024-03-27 11:30:45",
  "external_url": "https://facebook.com/3432042343434323/7179414779038416896",
  "errors": []
}
],
"versions": [
  {
    "account_id": 0,
    "is_original": true,
    "content": [
      {
        "body": "<div>Optimize your team's social media strategy with Mixpost or launch your SaaS quickly and start generating revenue effortlessly.</div>",
        "media": [
          {
            "id": "2",
            "name": "tea-reduced-file-size.mp4",
            "mime_type": "video/mp4",
            "type": "video",
            "url": "https://your-domain.com/storage/2576cb55-ab0f-3708-9388-6d03290fcb3f/uploads/03-2024/9LD3AR2JF6MHl79rG7qWxGdEiqzneaOxMcnuw1M7.mp4",
            "thumb_url": "https://your-domain.com/storage/2576cb55-ab0f-3708-9388-6d03290fcb3f/uploads/03-2024/9LD3AR2JF6MHl79rG7qWxGdEiqzneaOxMcnuw1M7-thumb.jpg",
            "is_video": true,
            "created_at": "2024-03-29 15:33:32"
          }
        ],
        "url": ""
      }
    ],
    "options": {
      "tiktok": {
        "privacy_level": {
          "account-0": null
        },
        "allow_comments": {
          "account-0": false
        },
        "allow_duet": {
          "account-0": false
        },
        "allow_stitch": {
          "account-0": false
        },
        "content_disclosure": {
          "account-0": false
        },
        "brand_organic_toggle": {
          "account-0": false
        },
        "brand_content_toggle": {
          "account-0": false
        },
      },
      "youtube": {
        "title": null,
        "status": "public"
      },
      "linkedin": {
        "visibility": "PUBLIC"
      },
      "mastodon": {
        "sensitive": false
      },
      "instagram": {
        "type": "post"
      },
      "pinterest": {
        "title": null,
        "link": null,
        "boards": {
          "account-0": null
        }
      },
      "facebook_page": {
        "type": "post"
      }
    }
  }
],
"tags": [
  {
    "id": 1,
    "uuid": "2323e1eb-b3a6-4183-990d-4d5afea04835",
    "name": "motivation",
    "hex_color": "#60a5fa"
  }
],
"user": {
  "name": "Dima Botezatu"
},
"scheduled_at": "2024-03-29 09:50:56",
"published_at": "2024-03-29 09:51:10",
"created_at": "2024-03-29 09:50:46",
"trashed": false
}
],
"links": {
  "first": "https://your-domain.com/your-core-path/api/2576cb55-ab0f-3708-9388-6d03290fcb3f/posts?page=1",
  "last": "https://your-domain.com/your-core-path/api/2576cb55-ab0f-3708-9388-6d03290fcb3f/posts?page=1",
  "prev": null,
  "next": null
},
"meta": {
  "current_page": 1,
  "from": 1,
  "last_page": 1,
  "links": [
    {
      "url": null,
      "label": "&laquo; Previous",
      "active": false
    },
    {
      "url": "https://your-domain.com/your-core-path/api/2576cb55-ab0f-3708-9388-6d03290fcb3f/posts?page=1",
      "label": "1",
      "active": true
    },
    {
      "url": null,
      "label": "Next &raquo;",
      "active": false
    }
  ],
  "path": "https://your-domain.com/your-core-path/api/2576cb55-ab0f-3708-9388-6d03290fcb3f/posts",
  "per_page": 20,
  "to": 3,
  "total": 3
}
}
[GET] Get a post

Method: GET
Endpoint: /{yourCorePath}/api/{workspaceUuid}/posts/{postUuid}
Authorization
: Bearer
Response:

{
  "id: 1,
  "uuid": "b1b06706-ef95-42b7-8ac8-d648dc9a9d65",
  "status": "published",
  "accounts": [
    {
      "id": 2,
      "uuid": "cfbdc3eb-22cb-4d15-b2a0-63d5fcd5bd92",
      "name": "Dima Botezatu",
      "username": "dimabotezatu",
      "image": null,
      "provider": "linkedin",
      "data": null,
      "authorized": true,
      "created_at": "2024-03-29 09:49:22",
      "external_url": "https://linkedin.com/feed/update/urn:li:share:43536647554322",
      "errors": []
    },
    {
      "id": 1,
      "uuid": "85347d5e-9724-4cb6-b91c-82d6d6d4e992",
      "name": "Mixpost",
      "username": "getmixpost",
      "image": "https://example.com/avatar/mixpost.jpg",
      "provider": "facebook_page",
      "data": {
        "suffix": {
          "value": "Page",
          "edited": false
        }
      },
      "authorized": true,
      "created_at": "2024-03-27 11:30:45",
      "external_url": "https://facebook.com/3432042343434323/7179414779038416896",
      "errors": []
    }
  ],
  "versions": [
    {
      "account_id": 0,
      "is_original": true,
      "content": [
        {
          "body": "<div>Optimize your team's social media strategy with Mixpost or launch your SaaS quickly and start generating revenue effortlessly.</div>",
          "media": [
            {
              "id": "2",
              "name": "tea-reduced-file-size.mp4",
              "mime_type": "video/mp4",
              "type": "video",
              "url": "https://your-domain.com/storage/2576cb55-ab0f-3708-9388-6d03290fcb3f/uploads/03-2024/9LD3AR2JF6MHl79rG7qWxGdEiqzneaOxMcnuw1M7.mp4",
              "thumb_url": "https://your-domain.com/storage/2576cb55-ab0f-3708-9388-6d03290fcb3f/uploads/03-2024/9LD3AR2JF6MHl79rG7qWxGdEiqzneaOxMcnuw1M7-thumb.jpg",
              "is_video": true,
              "created_at": "2024-03-29 15:33:32"
            }
          ],
          "url": ""
        }
      ],
      "options": {
        "tiktok": {
          "privacy_level": {
            "account-0": null
          },
          "allow_comments": {
            "account-0": false
          },
          "allow_duet": {
            "account-0": false
          },
          "allow_stitch": {
            "account-0": false
          },
          "content_disclosure": {
            "account-0": false
          },
          "brand_organic_toggle": {
            "account-0": false
          },
          "brand_content_toggle": {
            "account-0": false
          },
        },
        "youtube": {
          "title": null,
          "status": "public"
        },
        "linkedin": {
          "visibility": "PUBLIC"
        },
        "mastodon": {
          "sensitive": false
        },
        "instagram": {
          "type": "post"
        },
        "pinterest": {
          "title": null,
          "link": null,
          "boards": {
            "account-0": null
          }
        },
        "facebook_page": {
          "type": "post"
        }
      }
    }
  ],
  "tags": [
    {
      "id": 1,
      "uuid": "2323e1eb-b3a6-4183-990d-4d5afea04835",
      "name": "motivation",
      "hex_color": "#60a5fa"
    }
  ],
  "user": {
    "name": "Dima Botezatu"
  },
  "scheduled_at": "2024-03-29 09:50:56",
  "published_at": "2024-03-29 09:51:10",
  "created_at": "2024-03-29 09:50:46",
  "trashed": false
}
[POST] Create a post

Method: POST
Endpoint: /{yourCorePath}/api/{workspaceUuid}/posts
Authorization
: Bearer
Body:

{
  "date": "2024-05-23",
  "time": "15:00",
  "timezone": "Europe/Chisinau",
  "schedule": true,
  "schedule_now": true,
  "queue": true,
  "accounts": [1,2,3],
  "tags": [1,2],
  "versions": [
    {
      "account_id": 0,
      "is_original": true,
      "content": [
        {
          "body": "This is the content",
          "media": [1]
        }
      ],
      "options": {
        "mastodon": {
          "sensitive": false
        }
      }
    }
  ]
}
Key Format Required Description
date Y-m-d

time H:i

timezone Europe/Chisinau
Specify your preferred time zone when necessary. In its absence, Mixpost will default to the timezone set for your account.
schedule
boolean
Set to `true` to schedule the post.
Set to `false` to create the post without scheduling.
schedule_now
boolean

queue
boolean
Set to `true` to add the post to the queue.
accounts
array
Array of account IDs
accounts.*
integer required Account ID
tags
array
Array of tag IDs
tags.*
integer required
Tag ID
versions
array required
Array of version objects
versions.*.account_id
integer required
Specify the account for which the version is available. 
For the original version, use the value `0`.
versions.*.is_original
boolean required
The first version is always set to `true`.
versions.*.content
array required
Array of content objects
versions.*.content.*.body
null|string
Insert your post content text
versions.*.content.*.url
null|string
Insert a URL for the post. Facebook and LinkedIn support it.
versions.*.content.*.media
array
Array of media IDs
versions.*.content.*.media.*
integer required
Media ID
versions.*.options
object

Options available for each social service provider:

{
  "facebook_page": {
    "type": "post" // post,reel,story
  },
  "instagram": {
    "type": "post" // post,reel,story
  },
  "linkedin": {
    "visibility": "PUBLIC" // PUBLIC,CONNECTIONS
  },
  "mastodon": {
    "sensitive": false // boolean
  },
  "pinterest": {
    "link": null, // null|string
    "title": "", // string
    "boards": {
      "account-1": "971672010430333260" // string | The key `account-*` is the ID of your Pinterest account
    }
  },
  "tiktok": {
    "privacy_level": {
      "account-2": 'PUBLIC_TO_EVERYONE' // string | PUBLIC_TO_EVERYONE,MUTUAL_FOLLOW_FRIENDS,SELF_ONLY | The key `account-*` is the ID of your TikTok account. 
    },
    "allow_comments": {
      "account-2": true // boolean | The key `account-*` is the ID of your TikTok account
    },
    "allow_duet": {
      "account-2": false // boolean | The key `account-*` is the ID of your TikTok account
    },
    "allow_stitch": {
      "account-2": false // boolean | The key `account-*` is the ID of your TikTok account
    },
    "content_disclosure": {
       "account-2": false // boolean | The key `account-*` is the ID of your TikTok account
    },
    "brand_organic_toggle": {
      "account-2": false // boolean | The key `account-*` is the ID of your TikTok account
    },
	"brand_content_toggle": {
      "account-2": false // boolean | The key `account-*` is the ID of your TikTok account
    },
  }
}
[PUT] Update a post

Method: PUT
Endpoint: /{yourCorePath}/api/{workspaceUuid}/posts/{postUuid}
Authorization
: Bearer
Body:

{
  "date": "2024-05-23",
  "time": "16:00",
  "timezone": "Europe/Chisinau",
  "accounts": [1,2,3],
  "tags": [1,2],
  "versions": [
    {
      "account_id": 0,
      "is_original": true,
      "content": [
        {
          "body": "This is the content v2",
          "media": [1]
        }
      ],
      "options": {
        "mastodon": {
          "sensitive": false
        }
      }
    }
  ]
}
[POST] Schedule a post

Method: POST
Endpoint: /{yourCorePath}/api/{workspaceUuid}/posts/schedule/{postUuid}
Authorization
: Bearer
Body:

{
	"postNow": true
}
Key Format Required Description
postNow boolean required Set to `true` to schedule the post now. 
Set to `false' to schedule the post at the set post time.
[POST] Add a post to Queue

Method: POST
Endpoint: /{yourCorePath}/api/{workspaceUuid}/posts/add-to-queue/{postUuid}
Authorization
: Bearer

[DEL] Delete a post

Method: DEL
Endpoint: /{yourCorePath}/api/{workspaceUuid}/posts/{postUuid}
Authorization
: Bearer

[DEL] Delete multiple posts

Method: DEL
Endpoint: /{yourCorePath}/api/{workspaceUuid}/posts
Authorization
: Bearer
Params:

{
  "posts": ['8eb4e98d-2b93-44bd-a664-7a6438eff67b', 'b1b06706-ef95-42b7-8ac8-d648dc9a9d65']
}
Key Format Required Description
posts array required Array of posts Uuids
posts.* string required Post Uuid