Automate Pinata for free on Stepper

New File

Triggers when a new file is uploaded or pinned to your Pinata account on the selected network. Polls the Pinata Files API and deduplicates by file id.

• 3 parameters
• Network
• Group
• MIME Type Filter

New Pin Request

Triggers when a new pin-by-CID request is created in your Pinata account. Polls the Pin Requests API and deduplicates by request id.

• 1 parameters
• Status Filter

New File (Webhook)

Triggers when Pinata fires the file_added webhook event. Pinata does not provide a public API for subscribing to webhooks, so you must add the webhook manually: open https://app.pinata.cloud/developers/webhooks, click Create Webhook, paste the Stepper webhook URL shown after you save this trigger, and enable the desired file_added event(s). Pinata uses Svix for delivery.

• 1 parameters
• Network

Upload File

Uploads a file to IPFS via Pinata. Returns the file's CID, ID, and metadata. The file can optionally be added to a group and decorated with keyvalues metadata.

• 5 parameters
• File
• Network
• File Name
• Group
• Key-Value Metadata

Pin JSON to IPFS

Pins a raw JSON document to IPFS via Pinata's pinJSONToIPFS endpoint. Returns the resulting CID (IpfsHash). Use this for NFT metadata or other small JSON payloads (capped at 10 MB).

• 4 parameters
• JSON Content
• Pin Name
• Key-Value Metadata
• CID Version

Pin by CID

Pins existing IPFS content (identified by CID) into your Pinata account. The pin is processed asynchronously - use the New Pin Request trigger or query pin requests to track progress.

• 4 parameters
• CID
• Pin Name
• Key-Value Metadata
• Host Nodes

Create Signed Upload URL

Generates a presigned upload URL that can be handed to a client (browser, mobile app) so they can upload directly to Pinata without exposing your JWT.

• 7 parameters
• Network
• Expires (Seconds)
• Max File Size (Bytes)
• Allowed MIME Types
• Group
• Filename
• Key-Value Metadata

Create Download Link

Generates a time-limited signed gateway URL for retrieving a private file. Required because private files are encrypted and cannot be accessed via a plain gateway URL. Requires gateway_domain to be set on the connection.

• 2 parameters
• File
• Expires (Seconds)

List Files

Returns a paginated list of files on the selected network with optional filters.

• 7 parameters
• Network
• Name Filter
• Group
• MIME Type
• CID
• Limit
• Order

Find File

Looks up a single file by CID or by name. Returns the first match. Useful for chaining a recently-pinned CID into a later step that needs the Pinata file ID.

• 3 parameters
• Network
• CID
• Name

Update File

Updates the display name and/or keyvalues metadata for an existing file.

• 4 parameters
• Network
• File
• New Name
• Key-Value Metadata

Delete File

Deletes a file from Pinata (unpins it from IPFS).

• 2 parameters
• Network
• File

Create Group

Creates a new group on the selected network. Groups organize files into collections.

• 3 parameters
• Network
• Group Name
• Is Public

Update Group

Renames a group or toggles its visibility.

• 4 parameters
• Network
• Group
• New Name
• Is Public

Delete Group

Deletes a group. Files in the group are not deleted.

• 2 parameters
• Network
• Group

Add File to Group

Adds a file to a group.

• 3 parameters
• Network
• Group
• File

Remove File from Group

Removes a file from a group. The file itself is not deleted.

• 3 parameters
• Network
• Group
• File

Make HTTP Request

Make an HTTP request to any URL with full control over method, headers, and body.