Connect your tools

Useful links.
Useful workflows.

Start with one action that saves you a little work.

Save links submitted through a form

1. Create an API key in Settings → Integrations.
2. Add an HTTP request after your form’s submission trigger.
3. Use POST, the URL and headers below, and map the submitted URL, title, and note into the JSON body.
4. Test with a disposable link and check it in Pinport before enabling the workflow.

POST https://pinport.app/api/v2/bookmarks
X-Api-Key: YOUR_API_KEY
Content-Type: application/json

{
  "url": "https://example.com/useful-article",
  "title": "An article for the redesign",
  "note": "Suggested during our planning meeting",
  "tags": ["Website redesign", "Research"]
}

Keep the API key in the automation tool’s secret storage. Do not put it in a public form or browser script. Repeated create requests can create duplicates; track processed submissions if the trigger retries.

React when a bookmark is saved

Use a bookmark.created webhook to send a newly saved link to another tool, such as a personal task inbox or a private reading log.

1. Create a webhook receiver in your automation tool and copy its URL.
2. Add that URL in Pinport’s integration settings, select bookmark.created, and configure a secret.
3. Verify the webhook signature before trusting the payload. Filter by a tag if the workflow should handle only certain links.
4. Read the title, URL, note, and tags from the event data, and create the destination item.
5. Track the event’s id so a repeated delivery does not create the item twice.

Bulk imports produce bookmarks.imported events, rather than one bookmark.created event per link. Use the returned bookmark IDs with the API if your workflow should process an import. See webhook payloads and verification.

Build a project reference list

Request /api/v2/bookmarks?tag=Website%20redesign&limit=100 from a server or automation tool. Follow nextCursor until it is null. Format the returned titles and URLs for a private project document. Use a schedule if you want to refresh it periodically.

Adding another tag parameter narrows the result to bookmarks with both tags. A filter in your private library does not itself publish a shareable collection.

Using Zapier

Choose the HTTP request or webhook capability available in your Zapier plan. Map the request and response fields from the examples above. Configure Pinport authentication explicitly; this guide does not assume a native Pinport app.

Using Make

Use an HTTP request module to call API v2, or a webhook receiver for Pinport events. Pass JSON with the Content-Type and X-Api-Key headers, and inspect error responses during testing.

Using n8n

Use an HTTP Request step for the API or a Webhook trigger for events. Store the API key as a credential. For incoming events, preserve the raw request body if you verify signatures in code.

Build your own application

Use the API reference for pagination, filters, and write operations. Use the webhook guide for signatures and event shapes. Handle 429 responses with backoff, keep writes idempotent in your own workflow, and test failures as well as successful requests.