Skip to content

Marketing Consent

All operations require authentication.

2 operationsv1/me/marketing
Agent setup

Retrieve user marketing consent detailsProduction

GET
/1.0/me/marketing

Response

200Consentsuccessful operation
call
ConsentDetails

Details for call marketing communication

denyAll
boolean

Stop all marketing communication

denyUntil
stringdate-time

Stop marketing communication until this date

email
ConsentDetails

Details for email marketing communication

sms
ConsentDetails

Details for sms marketing communication

Reads your token from $OVH_TOKEN

$ curl https://api.eu.ovhcloud.com/1.0/me/marketing \
  -H "authorization: Bearer $OVH_TOKEN"
ResponseExample
{ "call": { "events": true, "newProductRecommendation": true, "newsletter": true, "offerAndDiscount": true }, "denyAll": true, "denyUntil": "2024-01-01T12:00:00Z", "email": { "events": true, "newProductRecommendation": true, "newsletter": true, "offerAndDiscount": true }, "sms": { "events": true, "newProductRecommendation": true, "newsletter": true, "offerAndDiscount": true }}

Update user marketing consentProduction

PUT
/1.0/me/marketing

Request body (required)

call
ConsentDetails

Details for call marketing communication

denyAll
boolean

Stop all marketing communication

denyUntil
stringdate-time

Stop marketing communication until this date

email
ConsentDetails

Details for email marketing communication

sms
ConsentDetails

Details for sms marketing communication

Response

200Consentsuccessful operation
call
ConsentDetails

Details for call marketing communication

denyAll
boolean

Stop all marketing communication

denyUntil
stringdate-time

Stop marketing communication until this date

email
ConsentDetails

Details for email marketing communication

sms
ConsentDetails

Details for sms marketing communication

Reads your token from $OVH_TOKEN

$ curl https://api.eu.ovhcloud.com/1.0/me/marketing \
  -H "authorization: Bearer $OVH_TOKEN"
ResponseExample
{ "call": { "events": true, "newProductRecommendation": true, "newsletter": true, "offerAndDiscount": true }, "denyAll": true, "denyUntil": "2024-01-01T12:00:00Z", "email": { "events": true, "newProductRecommendation": true, "newsletter": true, "offerAndDiscount": true }, "sms": { "events": true, "newProductRecommendation": true, "newsletter": true, "offerAndDiscount": true }}