Attachments
create
attachments.create
Create a contest or a social unlock
Risk: write
attachment full type
attachment full type
delete
attachments.delete
Delete a contest or unlock; there is no restore route
Risk: destructive · Irreversible
object
Output full type
Output full type
entries
attachments.entries
Read a contest entry time series, by platform
Risk: read
data full type
data full type
totals full type
totals full type
entriesTotals
attachments.entriesTotals
Read entry counts over the past day, week, month and lifetime
Risk: read
data full type
data full type
totals full type
totals full type
get
attachments.get
Read one contest or unlock with its actions
Risk: read
attachment full type
attachment full type
listForUser
attachments.listForUser
List one user’s contests and social unlocks
Risk: read
attachments full type
attachments full type
unlockPlatforms
attachments.unlockPlatforms
Read unlock counts by platform
Risk: read
data full type
data full type
totals full type
totals full type
unlocks
attachments.unlocks
Read a social unlock time series
Risk: read
data full type
data full type
totals full type
totals full type
unlocksTotals
attachments.unlocksTotals
Read unlock counts over the past day, week, month and lifetime
Risk: read
data full type
data full type
totals full type
totals full type
update
attachments.update
Change the fields of one contest or unlock
Risk: write
attachment full type
attachment full type
Campaigns
create
campaigns.create
Create an ad campaign on Facebook or Google; creating one can start spend, so review the body before calling
Risk: destructive
ad_campaign full type
ad_campaign full type
creativeInsights
campaigns.creativeInsights
Read performance data for each ad within a campaign
Risk: read
data full type
data full type
series full type
series full type
delete
campaigns.delete
Delete an ad campaign; there is no restore route
Risk: destructive · Irreversible
object
Output full type
Output full type
get
campaigns.get
Read one ad campaign
Risk: read
ad_campaign full type
ad_campaign full type
insights
campaigns.insights
Read one campaign performance data
Risk: read
data full type
data full type
series full type
series full type
list
campaigns.list
List one user’s ad campaigns
Risk: read
ad_campaigns full type
ad_campaigns full type
update
campaigns.update
Change an ad campaign; only the given fields are sent
Risk: destructive
status to pause or resume.
Output
ad_campaign full type
ad_campaign full type
Links
create
links.create
Create a link with its target, artwork, services and social settings
Risk: write
pixels full type
pixels full type
services full type
services full type
link full type
link full type
delete
links.delete
Delete a link; there is no restore route
Risk: destructive · Irreversible
object
Output full type
Output full type
expand
links.expand
Expand a music or podcast URL into the tracking pixels, affiliate codes and services a link would carry
Risk: read
pixels full type
pixels full type
services full type
services full type
get
links.get
Read one link with its services, pixels and social settings
Risk: read
link full type
link full type
insights
links.insights
Read one link’s performance over a date window
Risk: read
data full type
data full type
series full type
series full type
insightsOverview
links.insightsOverview
Read a summary of one link’s performance
Risk: read
data full type
data full type
series full type
series full type
listForUser
links.listForUser
List one user’s links
Risk: read
links full type
links full type
update
links.update
Change the fields of one link; only the given fields are sent
Risk: write
pixels full type
pixels full type
services full type
services full type
link full type
link full type
validPath
links.validPath
Check whether a path and subdomain are still available; answers 200 with valid: false rather than failing
Risk: read
valid: false and a reason; it is not an error.
Output
Offline Conversions
upload
offlineConversions.upload
Upload offline conversions for a user
Risk: write
events full type
events full type
object
Output full type
Output full type
Playbooks
create
playbooks.create
Create a playbook campaign from a template
Risk: destructive
playbook_campaign full type
playbook_campaign full type
delete
playbooks.delete
Delete a playbook campaign; there is no restore route
Risk: destructive · Irreversible
object
Output full type
Output full type
get
playbooks.get
Read one playbook campaign
Risk: read
playbook_campaign full type
playbook_campaign full type
update
playbooks.update
Change a playbook campaign title or archive state
Risk: destructive
playbook_campaign full type
playbook_campaign full type
User Lists
create
userLists.create
Create a user list for a Facebook custom audience; the feature requires access from ToneDen support
Risk: write
user_lists full type
user_lists full type
list
userLists.list
List one user’s advertising user lists
Risk: read
user_lists full type
user_lists full type
updateContacts
userLists.updateContacts
Add or remove people in a user list
Risk: write
add full type
add full type
remove full type
remove full type
object
Output full type
Output full type
Users
get
users.get
Read a user profile
Risk: read
user full type
user full type
update
users.update
Change a user profile’s name, email or location
Risk: write
user full type
user full type