Attach File
pipedrive.attach_file
ActionCRM & salesconnection required
Calls the Pipedrive API with the connection's credentials.
Upload a file with POST /api/v1/files and link it to a deal, person, organization, activity, product or lead. The bytes travel as base64, which is the shape every Mantle download node emits.
Connection
- Required
- Yes — the node will not save without one
- Auth type
- API key
- Providers
- Pipedrive
- Secret shape
- the Pipedrive API token, or {"api_token": "…"}
- Config it needs
- company_domain
- Resolved by
- config.connection_id, else node.connection_id
Configuration
9 fields, 2 required. A dotted path is a nested object and name[] an array of objects — the editor renders the same tree.
| Field | Type | Required | Default | Constraints | Example |
|---|---|---|---|---|---|
file_base64 File contents, base64-encoded — e.g. {{ $json.file_content }} from an upstream download node. Raw text is rejected: this is the base64 envelope every Mantle download node emits, not the bytes themselves. | string | Yes | — | — | SGVsbG8sIFBpcGVkcml2ZQ== |
filename Name to store the file under, including its extension. | string | Yes | — | — | quote.pdf |
content_type MIME type of the file. Defaults to application/octet-stream. | string | No | — | — | — |
deal_id Id of the deal to attach the file to. | string | No | — | — | — |
person_id Id of the person to attach the file to. | string | No | — | — | — |
org_id Id of the organization to attach the file to. | string | No | — | — | — |
activity_id Id of the activity to attach the file to. | string | No | — | — | — |
product_id Id of the product to attach the file to. | string | No | — | — | — |
lead_id UUID of the lead to attach the file to. | string | No | — | — | — |
- At least one of deal_id, person_id, org_id, activity_id, product_id, lead_id must be set.
Example configuration
Every value below is the contract’s own example or default — nothing invented.
{
"file_base64": "SGVsbG8sIFBpcGVkcml2ZQ==",
"filename": "quote.pdf"
}Output
One shape.
result
The provider's response object, as returned.
Extra keys beyond the ones listed can appear.
{}Notes
- This resource has no API v2 endpoint yet, so the call goes to /api/v1 and pages with start/next_start rather than a cursor.
- The whole file is held in memory as base64, so this is for documents rather than large media.
See Attach File run in a workflow.
In a technical demo we add the Pipedrive connection, drop the node on the canvas and let Workflow Health pre-flight it before the first real run.