Skip to main content

Placid integration

Generate on-brand images, videos, and PDFs from Placid templates on behalf of your clients.

What it does

The Placid integration turns a client's Placid templates into workflow steps. Connect a client's Placid project once and your workflows can render images, multi-page PDFs, and videos from CRM records, form submissions, or schedules; merge PDFs; upload files and custom fonts for use in templates; manage templates and collections; and start a follow-up workflow the moment a render is ready.

Connect a Placid account

  1. Open your workspace in TaskJuice and go to Connections.
  2. Choose Placid and click Connect.
  3. In the Placid dashboard, open Projects, open the project whose templates you want to use, and click API Tokens in the left menu.
  4. Create a token, copy it, and paste it into TaskJuice.

Placid tokens belong to one project. Use one Placid project per client so credit usage stays separate, and create one TaskJuice connection per project. To rotate a token, revoke it under API Tokens, create a new one, and update the connection.

Triggers

Placid has no account-level webhooks. Instead, each create call carries a completion URL that Placid calls once when that render finishes. The triggers give you that URL.

  • placid/image-created fires when an image render finishes.
  • placid/pdf-created fires when a PDF render from Create PDF or Merge PDFs finishes.
  • placid/video-created fires when a video render finishes.

To use one:

  1. Add the trigger to a workflow and copy the Placid webhook URL shown on it.
  2. In the workflow that renders, paste that URL into Completion webhook URL on Create Image, Create PDF, Merge PDFs, or Create Video. The same URL works for all three triggers; TaskJuice routes each delivery by the kind of file it carries.
  3. Optional: set Passthrough on the create action (for example a client id) and the same value in the trigger's Passthrough filter. The trigger then fires only for renders tagged with that value.

Placid does not sign its callbacks, so the URL itself is the credential. Keep it private.

Actions

Images

  • placid/create-image renders an image from a template with your own text and pictures, with optional size, format, DPI, and S3 transfer.
  • placid/get-image returns an image render's status and, once finished, its file URL.
  • placid/delete-image deletes a generated image.

PDFs

  • placid/create-pdf renders a PDF with one page per entry, mixing templates as needed.
  • placid/merge-pdfs combines 2 to 10 existing PDFs into one.
  • placid/get-pdf returns a PDF render's status and file URL.
  • placid/delete-pdf deletes a generated PDF.

Videos

  • placid/create-video renders an mp4 by stitching template clips, with optional audio per clip.
  • placid/get-video returns a video render's status and file URL.
  • placid/delete-video deletes a generated video.

Media

  • placid/upload-media uploads a file from an earlier step and returns a URL you can use in a picture layer, a video clip, or Merge PDFs.

Fonts

  • placid/list-fonts lists the custom fonts in the project, optionally including older account-wide fonts.
  • placid/get-font returns one font. Its code is what a text layer takes as font.
  • placid/upload-font uploads a ttf, otf, woff, or woff2 file. Placid requires you to confirm you have the right to use the font.
  • placid/update-font renames a font.
  • placid/delete-font deletes a font. It fails while templates still use the font unless you turn on Force, in which case those templates fall back to the default font.

Templates

  • placid/list-templates lists templates, filtered by collection, title, or tag.
  • placid/get-template returns a template with its dynamic layer names, so you know which layers a create action can fill.
  • placid/create-template creates a blank template or duplicates an existing one.
  • placid/update-template renames a template or replaces its tags or custom data.
  • placid/delete-template deletes a template.

Collections

  • placid/list-collections, placid/get-collection, placid/create-collection, placid/update-collection, and placid/delete-collection manage collections, the folders Placid uses to group templates (for example one per client).

Template, collection, and font fields are dropdowns filled from the connected project. Switch any of them to an expression to map a value from an earlier step.

Return All and Limit

List Templates and List Fonts return one page of 20, and List Collections one page of 100. In the collapsed Pagination section:

  • Return All fetches every page. A read that would exceed 10,000 items fails with a RESULT_TRUNCATED error instead of returning a partial list.
  • Limit fetches only the first N items. It is ignored while Return All is on.

Known limitations

  • Renders are asynchronous. Create actions return status: queued; the file URL appears when the render finishes. Use a completion trigger or a Get action to pick up the file. Create Image alone also offers Create now, which renders immediately so the response carries the image URL; it is limited to 10 simultaneous requests and can fail when Placid is busy.
  • Placid calls the completion URL on success only. A failed render does not trigger a workflow; check it with a Get action.
  • Placid bills in credits: 1 per image, 2 per PDF page, and 10 per 10 seconds of video. Rendering stops when the client's plan runs out of credits.
  • The Placid API allows 60 requests per minute per token. Requests above that are retried automatically.
  • Videos are capped at 180 seconds. Uploaded media is kept in temporary storage only, and Placid keeps generated files for a limited time, so transfer or copy anything you need to keep.
Was this helpful?
Pipedrive integrationPlausible Analytics integration