Create, update, or delete a buyer profile / ICP (feeds article targeting + entity triples). Create: title+industry+demographics. Update: profileId + changed fields. Delete: profileId + del=true.

Requires the write:content scope.

post/api/v1/brand/icp

Request

  • Base URL: https://api.rctrl.com
  • URL: https://api.rctrl.com/api/v1/brand/icp
  • Auth: HTTP bearer

Request body

profileIdstring

Buyer profile id from get_brand. Leave it out to create one.

delboolean

true deletes the buyer profile

titlestring

Who the buyer is, like "Head of marketing at a SaaS company"

industrystring

The buyer's industry

companySizestring

Company size, like "11-50 employees"

painPointsstring[]

Problems the buyer wants solved, one per item

buyingTriggersstring[]

What makes them start looking, one per item

objectionsstring[]

Why they hesitate to buy, one per item

preferredChannelsstring[]

Where they look for answers, like Google or Reddit, one per item

demographicsobject

Demographics object; required on create (same shape the dashboard saves)

Response

Success; the payload is wrapped in a data envelope

dataunknown

Changes

No recorded changes to this operation across all 1 revision of this API.