Entrar

Crear campaña

POST https://{organization}.myguper.com/api/loyalty/campaign

Crea una nueva campaña de loyalty. La campaña define cómo se genera el cashback en un pedido — su alícuota (aliquot/aliquotType), disparador, ventana de validez y tipo de recompensa.

Solo name es estrictamente obligatorio en la API; los demás campos toman valores por defecto. Una campaña creada con trigger: audience-list se empareja automáticamente con un registro CampaignAudience que conduce la programación por audiencia.

Try-it values populated from environment ACME (Demo)


Autenticación

Token

Send your user token in the x-guper-authorization header. Endpoints that support a Public mode (e.g. acúmulo and resgate previews) accept the same request without the header — Private mode adds customer data and a confirmation token to the response.

Encabezados

Name Type Description
x-guper-authorization * string User token issued by Guper. Omit only on endpoints that explicitly support a Public mode.
Content-Type * string Always `application/json` for endpoints that accept a JSON body.

Cuerpo de la petición

Content-Type: application/json

{
    "name": "Aniversário — 10% cashback",
    "displayName": "Feliz aniversário!",                        // optional
    "beneficiaryType": "buyer",                                 // optional, referrer | buyer
    "trigger": "purchase",                                      // optional
    "eventType": "tier_achieved",                               // optional
    "type": "monetary",                                         // optional, monetary | point | coupon | notification
    "isActive": true,                                           // optional
    "isDraft": false,                                           // optional
    "rewardType": "monetary",                                   // optional, monetary | point
    "pointsDividend": 1,                                        // optional
    "pointsDivisor": 1,                                         // optional
    "aliquot": 1000,
    "aliquotType": 0,                                           // optional
    "coupon": 0,                                                // optional
    "recurrentByOrder": false,                                  // optional
    "availabilityMode": "consecutiveDays",                      // optional, consecutiveDays | dateRange
    "delayTime": 86400,                                         // optional
    "expiryTime": 1296000,                                      // optional
    "expiryPeriod": "<expiryPeriod>",                           // optional, week | month | year
    "dateRangeStart": "2026-03-01T00:00:00-03:00",              // optional
    "dateRangeEnd": "2026-12-31T23:59:59-03:00",                // optional
    "initAt": "2026-03-01T00:00:00-03:00",
    "finishAt": "2026-03-31T23:59:59-03:00",
    "storeGroups": "",
    "segmentations": "[]",
    "redemptionPolicy": 0,                                      // optional
    "messageSequence": "<messageSequence>",                     // optional
    "campaignTag": 0,                                           // optional
    "rewardSegmentAdd": "<rewardSegmentAdd>",                   // optional
    "rewardSegmentDel": "<rewardSegmentDel>",                   // optional
    "list": 0,                                                  // optional
    "reactivateWithActiveCards": false,                         // optional
    "skipWithActiveCards": true,                                // optional
    "reactivationDateStart": "<reactivationDateStart>",         // optional
    "reactivationDateEnd": "<reactivationDateEnd>"              // optional
}

Respuestas

Copied to clipboard