bulk Create Audience Segments

POST {{baseUrl}}/2024-07/marketing-solutions/audience-segments/create

Creates all segments with a valid configuration, and returns their IDs. For those that cannot be created, one or multiple errors are returned.

Request Body

{"data"=>[{"type"=>"<string>", "attributes"=>{"advertiserId"=>"<string>", "name"=>"<string>", "description"=>"<string>", "inMarket"=>{"country"=>"<string>", "buyingPower"=>["High", "Low"], "gender"=>"Female", "interestIds"=>["<string>", "<string>"], "brandIds"=>["<string>", "<string>"], "priceRange"=>["Low", "High"]}, "prospecting"=>{"usersType"=>"ProspectsOrNonBuyers", "daysSinceLastVisitMin"=>"<integer>", "daysSinceLastVisitMax"=>"<integer>"}, "location"=>{"pointsOfInterest"=>[{"name"=>"<string>", "latitude"=>"<double>", "longitude"=>"<double>"}, {"name"=>"<string>", "latitude"=>"<double>", "longitude"=>"<double>"}], "radiusInKm"=>"<integer>"}, "retargeting"=>{"daysSinceLastVisitMax"=>"<integer>", "daysSinceLastVisitMin"=>"<integer>", "visitorsType"=>"All"}, "lookalike"=>{"seedSegmentId"=>"<string>", "targetSize"=>"<long>"}}}, {"type"=>"<string>", "attributes"=>{"advertiserId"=>"<string>", "name"=>"<string>", "description"=>"<string>", "inMarket"=>{"country"=>"<string>", "buyingPower"=>["High", "VeryHigh"], "gender"=>"Male", "interestIds"=>["<string>", "<string>"], "brandIds"=>["<string>", "<string>"], "priceRange"=>["Medium", "Medium"]}, "prospecting"=>{"usersType"=>"ProspectsOrNonBuyers", "daysSinceLastVisitMin"=>"<integer>", "daysSinceLastVisitMax"=>"<integer>"}, "location"=>{"pointsOfInterest"=>[{"name"=>"<string>", "latitude"=>"<double>", "longitude"=>"<double>"}, {"name"=>"<string>", "latitude"=>"<double>", "longitude"=>"<double>"}], "radiusInKm"=>"<integer>"}, "retargeting"=>{"daysSinceLastVisitMax"=>"<integer>", "daysSinceLastVisitMin"=>"<integer>", "visitorsType"=>"All"}, "lookalike"=>{"seedSegmentId"=>"<string>", "targetSize"=>"<long>"}}}]}

HEADERS

KeyDatatypeRequiredDescription
Content-Typestring
Acceptstring

RESPONSES

status: OK

{&quot;data&quot;:[{&quot;attributes&quot;:{&quot;name&quot;:&quot;\u003cstring\u003e&quot;,&quot;description&quot;:&quot;\u003cstring\u003e&quot;,&quot;type&quot;:&quot;Prospecting&quot;,&quot;createdAt&quot;:&quot;\u003cdateTime\u003e&quot;,&quot;updatedAt&quot;:&quot;\u003cdateTime\u003e&quot;,&quot;advertiserId&quot;:&quot;\u003cstring\u003e&quot;,&quot;inMarket&quot;:{&quot;country&quot;:&quot;\u003cstring\u003e&quot;,&quot;buyingPower&quot;:[&quot;VeryHigh&quot;,&quot;Low&quot;],&quot;gender&quot;:&quot;Unknown&quot;,&quot;interestIds&quot;:[&quot;\u003cstring\u003e&quot;,&quot;\u003cstring\u003e&quot;],&quot;brandIds&quot;:[&quot;\u003cstring\u003e&quot;,&quot;\u003cstring\u003e&quot;],&quot;priceRange&quot;:[&quot;Medium&quot;,&quot;High&quot;]},&quot;prospecting&quot;:{&quot;daysSinceLastVisitMin&quot;:&quot;\u003cinteger\u003e&quot;,&quot;daysSinceLastVisitMax&quot;:&quot;\u003cinteger\u003e&quot;,&quot;usersType&quot;:&quot;Prospects&quot;},&quot;contactList&quot;:{&quot;isReadOnly&quot;:&quot;\u003cboolean\u003e&quot;},&quot;location&quot;:{&quot;pointsOfInterest&quot;:[{&quot;name&quot;:&quot;\u003cstring\u003e&quot;,&quot;latitude&quot;:&quot;\u003cdouble\u003e&quot;,&quot;longitude&quot;:&quot;\u003cdouble\u003e&quot;},{&quot;name&quot;:&quot;\u003cstring\u003e&quot;,&quot;latitude&quot;:&quot;\u003cdouble\u003e&quot;,&quot;longitude&quot;:&quot;\u003cdouble\u003e&quot;}],&quot;radiusInKm&quot;:&quot;\u003cinteger\u003e&quot;,&quot;registryType&quot;:&quot;Unknown&quot;},&quot;behavioral&quot;:{&quot;category&quot;:&quot;BuyingPatterns&quot;,&quot;country&quot;:&quot;\u003cstring\u003e&quot;,&quot;startDate&quot;:&quot;\u003cdateTime\u003e&quot;,&quot;endDate&quot;:&quot;\u003cdateTime\u003e&quot;},&quot;retargeting&quot;:{&quot;visitorsType&quot;:&quot;NonBuyers&quot;,&quot;daysSinceLastVisitMin&quot;:&quot;\u003cinteger\u003e&quot;,&quot;daysSinceLastVisitMax&quot;:&quot;\u003cinteger\u003e&quot;},&quot;lookalike&quot;:{&quot;seedSegmentId&quot;:&quot;\u003cstring\u003e&quot;,&quot;targetSize&quot;:&quot;\u003clong\u003e&quot;}},&quot;id&quot;:&quot;\u003cstring\u003e&quot;,&quot;type&quot;:&quot;\u003cstring\u003e&quot;},{&quot;attributes&quot;:{&quot;name&quot;:&quot;\u003cstring\u003e&quot;,&quot;description&quot;:&quot;\u003cstring\u003e&quot;,&quot;type&quot;:&quot;Lookalike&quot;,&quot;createdAt&quot;:&quot;\u003cdateTime\u003e&quot;,&quot;updatedAt&quot;:&quot;\u003cdateTime\u003e&quot;,&quot;advertiserId&quot;:&quot;\u003cstring\u003e&quot;,&quot;inMarket&quot;:{&quot;country&quot;:&quot;\u003cstring\u003e&quot;,&quot;buyingPower&quot;:[&quot;High&quot;,&quot;High&quot;],&quot;gender&quot;:&quot;Female&quot;,&quot;interestIds&quot;:[&quot;\u003cstring\u003e&quot;,&quot;\u003cstring\u003e&quot;],&quot;brandIds&quot;:[&quot;\u003cstring\u003e&quot;,&quot;\u003cstring\u003e&quot;],&quot;priceRange&quot;:[&quot;Unknown&quot;,&quot;Medium&quot;]},&quot;prospecting&quot;:{&quot;daysSinceLastVisitMin&quot;:&quot;\u003cinteger\u003e&quot;,&quot;daysSinceLastVisitMax&quot;:&quot;\u003cinteger\u003e&quot;,&quot;usersType&quot;:&quot;Unknown&quot;},&quot;contactList&quot;:{&quot;isReadOnly&quot;:&quot;\u003cboolean\u003e&quot;},&quot;location&quot;:{&quot;pointsOfInterest&quot;:[{&quot;name&quot;:&quot;\u003cstring\u003e&quot;,&quot;latitude&quot;:&quot;\u003cdouble\u003e&quot;,&quot;longitude&quot;:&quot;\u003cdouble\u003e&quot;},{&quot;name&quot;:&quot;\u003cstring\u003e&quot;,&quot;latitude&quot;:&quot;\u003cdouble\u003e&quot;,&quot;longitude&quot;:&quot;\u003cdouble\u003e&quot;}],&quot;radiusInKm&quot;:&quot;\u003cinteger\u003e&quot;,&quot;registryType&quot;:&quot;PointOfInterest&quot;},&quot;behavioral&quot;:{&quot;category&quot;:&quot;Lifestyles&quot;,&quot;country&quot;:&quot;\u003cstring\u003e&quot;,&quot;startDate&quot;:&quot;\u003cdateTime\u003e&quot;,&quot;endDate&quot;:&quot;\u003cdateTime\u003e&quot;},&quot;retargeting&quot;:{&quot;visitorsType&quot;:&quot;All&quot;,&quot;daysSinceLastVisitMin&quot;:&quot;\u003cinteger\u003e&quot;,&quot;daysSinceLastVisitMax&quot;:&quot;\u003cinteger\u003e&quot;},&quot;lookalike&quot;:{&quot;seedSegmentId&quot;:&quot;\u003cstring\u003e&quot;,&quot;targetSize&quot;:&quot;\u003clong\u003e&quot;}},&quot;id&quot;:&quot;\u003cstring\u003e&quot;,&quot;type&quot;:&quot;\u003cstring\u003e&quot;}],&quot;warnings&quot;:[{&quot;traceId&quot;:&quot;\u003cstring\u003e&quot;,&quot;traceIdentifier&quot;:&quot;\u003cstring\u003e&quot;,&quot;type&quot;:&quot;availability&quot;,&quot;code&quot;:&quot;\u003cstring\u003e&quot;,&quot;instance&quot;:&quot;\u003cstring\u003e&quot;,&quot;title&quot;:&quot;\u003cstring\u003e&quot;,&quot;detail&quot;:&quot;\u003cstring\u003e&quot;,&quot;source&quot;:{&quot;reprehenderit_b&quot;:&quot;\u003cstring\u003e&quot;,&quot;dolore7a2&quot;:&quot;\u003cstring\u003e&quot;},&quot;stackTrace&quot;:&quot;\u003cstring\u003e&quot;},{&quot;traceId&quot;:&quot;\u003cstring\u003e&quot;,&quot;traceIdentifier&quot;:&quot;\u003cstring\u003e&quot;,&quot;type&quot;:&quot;availability&quot;,&quot;code&quot;:&quot;\u003cstring\u003e&quot;,&quot;instance&quot;:&quot;\u003cstring\u003e&quot;,&quot;title&quot;:&quot;\u003cstring\u003e&quot;,&quot;detail&quot;:&quot;\u003cstring\u003e&quot;,&quot;source&quot;:{&quot;nisi77d&quot;:&quot;\u003cstring\u003e&quot;,&quot;commodo5&quot;:&quot;\u003cstring\u003e&quot;,&quot;mollit_b&quot;:&quot;\u003cstring\u003e&quot;,&quot;officia_&quot;:&quot;\u003cstring\u003e&quot;},&quot;stackTrace&quot;:&quot;\u003cstring\u003e&quot;}],&quot;errors&quot;:[{&quot;traceId&quot;:&quot;\u003cstring\u003e&quot;,&quot;traceIdentifier&quot;:&quot;\u003cstring\u003e&quot;,&quot;type&quot;:&quot;access-control&quot;,&quot;code&quot;:&quot;\u003cstring\u003e&quot;,&quot;instance&quot;:&quot;\u003cstring\u003e&quot;,&quot;title&quot;:&quot;\u003cstring\u003e&quot;,&quot;detail&quot;:&quot;\u003cstring\u003e&quot;,&quot;source&quot;:{&quot;irure1b&quot;:&quot;\u003cstring\u003e&quot;,&quot;ina3&quot;:&quot;\u003cstring\u003e&quot;,&quot;irureb0b&quot;:&quot;\u003cstring\u003e&quot;,&quot;id_fa&quot;:&quot;\u003cstring\u003e&quot;},&quot;stackTrace&quot;:&quot;\u003cstring\u003e&quot;},{&quot;traceId&quot;:&quot;\u003cstring\u003e&quot;,&quot;traceIdentifier&quot;:&quot;\u003cstring\u003e&quot;,&quot;type&quot;:&quot;availability&quot;,&quot;code&quot;:&quot;\u003cstring\u003e&quot;,&quot;instance&quot;:&quot;\u003cstring\u003e&quot;,&quot;title&quot;:&quot;\u003cstring\u003e&quot;,&quot;detail&quot;:&quot;\u003cstring\u003e&quot;,&quot;source&quot;:{&quot;dolored&quot;:&quot;\u003cstring\u003e&quot;,&quot;irure__33&quot;:&quot;\u003cstring\u003e&quot;},&quot;stackTrace&quot;:&quot;\u003cstring\u003e&quot;}]}