Voluum Actions

Read and update campaigns, offers, and costs in your Voluum account directly from AffZero automations.

Overview

AffZero provides a set of Tracker Actions for Voluum that let you query and update your account without logging into the Voluum UI. All actions run against the Voluum REST API (api.voluum.com) and require a configured Voluum connection.

Voluum uses UUID strings for all entity IDs (campaigns, offers, etc.) — they look like 3fa85f64-5717-4562-b3fc-2c963f66afa6. Use a Get All action first to discover the IDs you need.

Campaign Actions

Get All Campaigns

Retrieve the complete list of campaigns in your Voluum account.

Returns: All campaigns with their IDs, names, traffic types, cost models, traffic sources, tags, and status.

Parameters: None required. Optionally pass includeDeleted: true to include archived campaigns.

Use this to: Look up a campaign UUID before using it in Get Campaign or Edit Campaign.

Get Campaign

Retrieve full details for a single Voluum campaign by its UUID.

Returns: Complete campaign configuration — cost model, postback URL, redirect target, traffic type, traffic source, tags, workspace, and all tracking URLs.

Parameters:

Field	Required	Description
Campaign ID	Yes	The Voluum campaign UUID

Edit Campaign

Update a campaign's configuration in Voluum. AffZero fetches the current campaign state before writing, so only the fields you specify are changed — everything else is preserved.

Editable fields:

Field	Description
Name	Campaign display name (`namePostfix`)
Postback URL	Global postback URL for the campaign
Cost Model Type	`CPC`, `CPM`, `CPV`, `CPA`, `REVSHARE`, or `NONE`
Cost Value	Fixed cost per event (depends on cost model type)
Tags	Comma-separated tags to assign to the campaign
Traffic Type	`POP`, `DOMAIN`, `NATIVE`, `PUSH`, `BANNER`, `SEARCH`, `SOCIAL`, `VIDEO`, `EMAIL`, `SMS`, or `OTHER`

Parameters: Campaign ID (required) + any fields to update.

Use Get Campaign first to see the campaign's current configuration before editing it.

Create Campaign

Create a new Voluum campaign via POST /campaign.

Required fields:

Field	Description
Name	Campaign display name (`namePostfix`)
Traffic Source ID	Voluum traffic source UUID
Workspace ID	Voluum workspace UUID
Flow ID or Redirect URL	Redirect target — provide one

Optional fields: Traffic Type (defaults to POP), Cost Model Type, Cost Value, Postback URL, Country Code, Tags.

Offer Actions

Get All Offers

Retrieve the complete list of offers in your Voluum account.

Returns: All offers with their IDs, names, URLs, payout settings, affiliate networks, tags, and verticals.

Parameters: None required. Optionally pass includeDeleted: true to include deleted offers.

Use this to: Find the UUID of an offer before using Get Offer or Edit Offer.

Get Offer

Retrieve full details for a single Voluum offer by its UUID.

Returns: Complete offer configuration — URL, payout model, affiliate network, cap configuration, country, tags, vertical, and tracking domain.

Parameters:

Field	Required	Description
Offer ID	Yes	The Voluum offer UUID

Edit Offer

Update an offer's configuration in Voluum. AffZero fetches the current offer state before writing, so only the fields you specify are changed.

Editable fields:

Field	Description
Name	Offer display name (`namePostfix`)
Offer URL	The tracking/destination URL for the offer
Payout Type	`AUTO` (payout from postback) or `MANUAL` (fixed value)
Payout Value	Fixed payout per conversion — used when Payout Type is `MANUAL`
Tags	Comma-separated tags to assign
Vertical	Offer category / vertical

Parameters: Offer ID (required) + any fields to update.

Create Offer

Create a new Voluum offer via POST /offer.

Required fields:

Field	Description
Name	Offer display name (`namePostfix`)
Offer URL	Tracking/destination URL
Workspace ID	Voluum workspace UUID

Optional fields: Affiliate Network ID, Country Code, Currency Code, Payout Type, Payout Value, Tags, Vertical.

Lander Actions

Get All Landers

Retrieve the complete list of landers in your Voluum account.

Returns: All landers with their IDs, names, URLs, tags, and workspace.

Parameters: None required. Optionally pass includeDeleted: true to include deleted landers.

Get Lander

Retrieve full details for a single Voluum lander by its UUID.

Parameters:

Field	Required	Description
Lander ID	Yes	The Voluum lander UUID

Create Lander

Create a new Voluum lander via POST /lander.

Required fields: Name, Lander URL, Workspace ID.

Optional fields: Country Code, Lander Type (defaults to LANDER), Tags.

Edit Lander

Update a lander's configuration. AffZero fetches the current lander state before writing, so only the fields you specify are changed.

Editable fields: Name, Lander URL, Country Code, Tags.

Parameters: Lander ID (required) + any fields to update.

Cost Actions

Update Campaign Costs

Post cost data for a Voluum campaign over a specific date range. Useful for keeping ROI calculations accurate after reconciling ad spend from a traffic source.

Parameters:

Field	Required	Description
Campaign ID	Yes	The Voluum campaign UUID
Cost	Yes	Total cost amount to record
Date From	Yes	Start of the period (ISO 8601, e.g. `2026-03-01T00:00:00Z`)
Date To	Yes	End of the period, exclusive (e.g. `2026-04-01T00:00:00Z`)

Bulk Cost Update

Update costs for multiple campaigns at once in a single action. AffZero posts to the Voluum /report/cost endpoint for each campaign and returns a per-campaign result summary.

Useful for:

Reconciling ad spend across many campaigns after a traffic run
Running cost updates as part of an automated workflow driven by AI analysis
Applying the same date range to a batch of campaigns without repeating the single Update Costs action

Parameters:

Field	Required	Description
Cost Entries	Yes	Campaign costs as `id:cost` pairs, comma-separated (e.g. `3fa85f64-...:50.00,abc12345-...:25.50`)
Date From	Yes	Start of the period for all campaigns (ISO 8601, e.g. `2026-05-01T00:00:00Z`)
Date To	Yes	End of the period, exclusive (e.g. `2026-05-02T00:00:00Z`)

Response: A summary with total, updated, failed, and a results array showing each campaign's outcome.

In automations, set Cost Entries to a variable like {ai_cost_updates} produced by an AI Analyze step. Instruct the AI to output campaign costs in "id:cost,id:cost,..." format — for example: "For each campaign, output its UUID and total spend as comma-separated id:cost pairs."

Tips for Voluum Users

UUIDs, not numbers — Voluum entity IDs are UUID strings, not short integers like Binom. Use the Get All actions to look up the correct UUID before referencing it in edit or get actions.
Get before Edit — AffZero automatically fetches the current state before a PUT, but running a Get action first in the same automation lets you use the retrieved data as variables in the edit step.
Cost model updates — when editing the cost model, specify both Cost Model Type and Cost Value together. Setting only the type without a value may leave the rate at zero.
Rate limits — Voluum limits API requests per minute. If you're running multiple automations against the same Voluum connection, stagger their schedules to avoid hitting the limit.