To jump right into the API docs, see the API integration guide.
Overview
We offer multiple options to sync with your data sources:- Native integration: Hubspot, Zendesk, Slack, Intercom, Stripe, ComplyAdvantage…
- API integration: we grant you access to Fragment’s API.
- Custom integration: in cases where no other options is available, we offer custom integration on top of your internal APIs.
- No code integration: use workflow platforms like Zapier, n8n, Make, etc. to push tasks to the Fragment API using a custom HTTP action node.
Option 1: Native Integration
We have existing integrations with a bunch of SaaS products (Zendesk, HubSpot, Intercom, ComplyAdvantage, etc.) and can easily add new ones on demand. Depending on the capabilities of the SaaS API we integrate with, the Fragment integration will be able to ingest the data from there as well as push data to them. For example,- if you use HubSpot, completing a task on Fragment can close the HubSpot task
- if you use Stripe, completing a task on Fragment can approve a Radar review
Please reach out if you want to integrate one of your existing 3rd party tools. We can easily add new ones on demand.
Option 2: API Integration
This method is the most versatile. You’re responsible for pushing data to the Fragment API when tasks are created, updated, or deleted. To integrate via the API, follow these steps- Locate the part of your system (Backend? Automation platform like Zapier?) that creates the tasks
- Format the data into a JSON that respects the Task Data Model. You usually need to specify the due date of the task (
due_at
), and somefields
to get started (title,
url` + custom fields). - Make a request to the
POST /tasks
endpoint - Update the task with the
PATCH /tasks
endpoint.
Option 3: Custom Integration
In the situation where you have a custom tool you want to integrate with, but have no engineering resources and no alternatives, we offer custom integration services that depend on the complexity of the underlying integration. Here is how it typically works:- Create a user for Fragment with the right permissions (read the backlog) and share an access token / API key with us.
- Every X minute (configurable, 5min by default), we refresh your backlog to fetch the open tasks.
- We close tasks not in the backlog anymore, and create new ones.
- (Incremental) We can also poll your system for recent changes to update tasks.
- Operators go through Fragment to complete tasks on their custom back-office.
Option 4: No-code integration
If the volume and the complexity of the setup is not too high, no-code tools like Zapier, Make, n8n, etc. can be a good fit. At a high-level, it typically works like this:- Connect the no-code tool to your internal APIs / data
- Create a workflow that creates or updates tasks in Fragment when some trigger occurs.
This part of the documentation is not 100% up to date (authentication methods, etc.), but should give you a good starting point.
Zapier
https://zapier.com There are 2 options to integrate with Zapier.- The first option is to use the Custom Request Webhook via Zapier.
- The second option is to use the
Code
Action from Zapier (available in Python and JavaScript flavors).

Code
action (option 2) : from Google sheet → Fragment
Let’s say you have a Google spreadsheet named zapier-demo with one sheet named Sheet 1.

- Create new Zap
- Add a Google Sheet Trigger on New or Updated Row.

- Add a Code Step. Configure the input data and make an HTTP API request.
-
See code
-
See code
- Navigate to the Fragment dashboard, you should now see the tasks !

Make
https://www.make.com The best option to integrate with Make is to create an HTTP action. Let’s see an example : from Google sheet → Fragment

-
Create a
Search Rows
Google Sheets trigger -
Add a
JSON
action to format the flat data into a proper JSON. This action enables you to define a schema for your data and is thus robust. In our case, let’s adopt a simple data structure that fits the Task Data Model

-
Add an HTTP action node. Make sure to
-
Select the
POST
method (orPUT
for idempotent upserts) -
Add an
Authorization: Bearer <token>
header -
Add
Content-Type: application/json
-
Fill the request content by selecting the output of the JSON step
-
Select the
-
Navigate to the Fragment dashboard, you should now see the tasks
n8n
https://n8n.io The best way to integrate with n8n is to use the HTTP request node. Let’s see an example : from Google sheet → Fragment

-
Create a Google Sheet Trigger on
rowAdded
-
Transform the data with a Code block (example below)
-
See Code (Javascript)
-
See Screenshot
-
See Code (Javascript)
-
Add an HTTP node
Make sure to
- Select method
POST
(orPUT
for idempotent upserts) - Include headers
Authorization: Bearer <token>
andContent-Type: application/json
- Retrieve the body from the previous step (already formatted) with
{{ $json }}
- Select method


-
Navigate to the Fragment dashboard, you should now see the tasks