ContentFries can act as the content engine inside your own agent or automation. Open Integrations in the authenticated app to manage workspaces, API keys, hosted MCP, and webhooks.

Agent integrations are included with Creator and Scale. A separately purchased automation add-on may enable them for another eligible plan. Lifetime access to the core product does not automatically include these capabilities.

Create an API key

  1. Open Integrations and choose the workspace the agent should use.
  2. Create a key with only the scopes the agent needs.
  3. Save the raw key immediately. ContentFries shows it only once.
  4. Send it as a bearer token to the Control API under /api/v1.

The key is permanently bound to one workspace. Requests cannot choose a different team or workspace by sending another ID.

Choose the smallest useful scopes

Available scope families cover projects, recipes, jobs, content review, Planner, credits, and webhooks. Start read-only and add write scopes only when the agent needs to change state.

Every state-changing API or MCP request needs an Idempotency-Key. Repeating the same successful request with the same key returns the saved result instead of doing the work twice.

Connect hosted MCP

Use the hosted MCP connection details shown in Integrations and authenticate with the same API key. MCP exposes the same business operations as the Control API, so your agent can list projects, run recipes, review content, or update Planner without a separate ContentFries implementation.

Add a webhook

  1. Add a public HTTPS endpoint in Integrations.
  2. Choose the events it should receive.
  3. Save the generated signing secret when it is shown.
  4. Verify the X-ContentFries-Signature before processing a delivery.

Available events include batch ready, content approved, content scheduled, content published, publish failed, and low credits. Failed deliveries are retried and can be replayed from the integration screen.

Use your existing publishing stack

An agent can pull approved assets and metadata from ContentFries, send them to your current scheduler, and update Planner when an item is scheduled or published. ContentFries does not require native social publishing for this workflow.

Successful automation writes have a one-credit surcharge on Free or Pay as you go when automation access is active. Creator and Scale waive this surcharge. Normal generation and rendering credit costs still apply on every plan.