Push

Push Coupon lists API

The Coupon lists API from Push — 3 operation(s) for coupon lists.

GitHub OpenAPI

Operations 6

POST /v2/account/{account_id}/coupon_lists Create — Coupon lists #
GET /v2/account/{account_id}/coupon_lists List — Coupon lists #
GET /v2/account/{account_id}/coupon_lists/{coupon_list_id} Show — Coupon lists #
PUT /v2/account/{account_id}/coupon_lists/{coupon_list_id} Update — Coupon lists #
DELETE /v2/account/{account_id}/coupon_lists/{coupon_list_id} Delete — Coupon lists #
PUT /v2/account/{account_id}/coupon_lists/redeem Redeem — Coupon lists #

Documentation

📖
Authentication
https://raw.githubusercontent.com/api-evangelist/push/refs/heads/main/authentication/push-authentication.yml
📖
RateLimits
https://raw.githubusercontent.com/api-evangelist/push/refs/heads/main/rate-limits/push-rate-limits.yml

Specifications

⚙
OpenAPI
https://raw.githubusercontent.com/api-evangelist/push/refs/heads/main/openapi/push-coupon-lists-api-openapi.yml
⚙
AsyncAPI
https://raw.githubusercontent.com/api-evangelist/push/refs/heads/main/asyncapi/push-webhooks-asyncapi.yml

Other Resources

🔗
Webhooks
https://raw.githubusercontent.com/api-evangelist/push/refs/heads/main/asyncapi/push-webhooks.yml
🔗
Conventions
https://raw.githubusercontent.com/api-evangelist/push/refs/heads/main/conventions/push-conventions.yml
🔗
ErrorCatalog
https://raw.githubusercontent.com/api-evangelist/push/refs/heads/main/errors/push-problem-types.yml
🔗
DataModel
https://raw.githubusercontent.com/api-evangelist/push/refs/heads/main/data-model/push-data-model.yml
🔗
Lifecycle
https://raw.githubusercontent.com/api-evangelist/push/refs/heads/main/lifecycle/push-lifecycle.yml
🔗
Conformance
https://raw.githubusercontent.com/api-evangelist/push/refs/heads/main/conformance/push-conformance.yml
🔗
AgenticAccess
https://raw.githubusercontent.com/api-evangelist/push/refs/heads/main/agentic-access/push-agentic-access.yml

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API 
curl "https://apis.io/api/v1/apis/push-coupon-lists-api"
All apis 
curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

push-coupon-lists-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: Cendyn CRM (PUSHTech) REST Coupon lists API
  version: v2
  description: Token-authenticated REST API for the Cendyn CRM (formerly PUSHTech) hospitality CRM / CDP platform.
  contact:
    name: Cendyn
    url: https://www.cendyn.com/contact-us/
  termsOfService: https://www.cendyn.com/terms-of-use/
  x-provenance:
    publisher: API Evangelist
    method: derived
    derived_from: https://developers.cendyncrm.com/api/docs
    provider_published_openapi: false
    note: NOT published by Cendyn. Derived from the provider's public HTML API reference; verify against the live docs before production use.
servers:
- url: https://api.eu.cendyncrm.com
  description: EU data center
- url: https://api.us.cendyncrm.com
  description: US data center
security:
- accountToken: []
tags:
- name: Coupon Lists
paths:
  /v2/account/{account_id}/coupon_lists:
    post:
      operationId: createCouponLists
      summary: Create — Coupon lists
      tags:
      - Coupon Lists
      externalDocs:
        description: Cendyn CRM API reference
        url: https://developers.cendyncrm.com/api/docs/coupons/create
      parameters:
      - name: account_id
        in: path
        required: true
        schema:
          type: string
        description: Your account unique identifier to access API.
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                name:
                  description: Name for the field.
                codes:
                  description: 'Array with codes, Max: 500'
                low_limit_notification:
                  description: Send notification email if only x coupons left
                notification_email:
                  description: Email to send notification.
              required:
              - name
              - codes
            example:
              name: Coupon list
              codes:
              - code_1
              - code_2
              low_limit_notification: 10
              notification_email: '[email protected]'
      responses:
        '201':
          description: Successful response
          content:
            application/json:
              example:
                coupon_list:
                  _id: 5853d8c2edb7aacab9000045
                  name: Coupon list
                  total_coupons: 2
                  used_coupons: 0
                  pending_coupons: 2
                  redeem_coupons: 0
                  low_limit_notification: 10
                  notification_email: '[email protected]'
        '401':
          description: 'Unauthorized — missing or invalid `Authorization: Token token=...` header.'
    get:
      operationId: listCouponLists
      summary: List — Coupon lists
      tags:
      - Coupon Lists
      externalDocs:
        description: Cendyn CRM API reference
        url: https://developers.cendyncrm.com/api/docs/coupons/list
      parameters:
      - name: account_id
        in: path
        required: true
        schema:
          type: string
        description: Your account unique identifier to access API.
      - name: page
        in: query
        required: false
        schema:
          type: string
        description: Page to retrieve
      - name: per_page
        in: query
        required: false
        schema:
          type: string
        description: 'Items per page: Max:100 , default:50'
      responses:
        '200':
          description: Successful response
          content:
            application/json:
              example:
                coupon_lists:
                - _id: 5853d8c2edb7aacab9000045
                  name: Coupon list
                  total_coupons: 4
                  used_coupons: 0
                  pending_coupons: 4
                  redeem_coupons: 0
                  low_limit_notification: 10
                  notification_email: '[email protected]'
                - _id: 5853d8c2edb7aacab9000046
                  name: Coupon list 2
                  total_coupons: 4
                  used_coupons: 0
                  pending_coupons: 4
                  redeem_coupons: 0
                  low_limit_notification: 10
                  notification_email: '[email protected]'
                - _id: 5853d8c2edb7aacab9000047
                  name: Coupon list 3
                  total_coupons: 4
                  used_coupons: 0
                  pending_coupons: 4
                  redeem_coupons: 0
                  low_limit_notification: 10
                  notification_email: '[email protected]'
        '401':
          description: 'Unauthorized — missing or invalid `Authorization: Token token=...` header.'
  /v2/account/{account_id}/coupon_lists/{coupon_list_id}:
    get:
      operationId: showCouponLists
      summary: Show — Coupon lists
      tags:
      - Coupon Lists
      externalDocs:
        description: Cendyn CRM API reference
        url: https://developers.cendyncrm.com/api/docs/coupons/show
      parameters:
      - name: account_id
        in: path
        required: true
        schema:
          type: string
        description: Your account unique identifier to access API.
      - name: coupon_list_id
        in: path
        required: true
        schema:
          type: string
        description: Id of coupon list
      responses:
        '200':
          description: Successful response
          content:
            application/json:
              example:
                coupon_list:
                  _id: 5853d8c2edb7aacab9000045
                  name: Coupon list
                  total_coupons: 2
                  used_coupons: 0
                  pending_coupons: 2
                  redeem_coupons: 0
                  low_limit_notification: 10
                  notification_email: '[email protected]'
        '401':
          description: 'Unauthorized — missing or invalid `Authorization: Token token=...` header.'
    put:
      operationId: updateCouponLists
      summary: Update — Coupon lists
      tags:
      - Coupon Lists
      externalDocs:
        description: Cendyn CRM API reference
        url: https://developers.cendyncrm.com/api/docs/coupons/update
      parameters:
      - name: account_id
        in: path
        required: true
        schema:
          type: string
        description: Your account unique identifier to access API.
      - name: coupon_list_id
        in: path
        required: true
        schema:
          type: string
        description: Id of coupon list
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                codes:
                  description: Array with codes, Max:500
                low_limit_notification:
                  description: Send notification email if only x coupons left
                notification_email:
                  description: Email to send notification.
            example:
              codes:
              - code_4
              - code_5
              low_limit_notification: 10
              notification_email: '[email protected]'
      responses:
        '200':
          description: Successful response
          content:
            application/json:
              example:
                coupon_list:
                  _id: 5853d8c2edb7aacab9000045
                  name: Coupon list
                  total_coupons: 4
                  used_coupons: 0
                  pending_coupons: 4
                  redeem_coupons: 0
                  low_limit_notification: 10
                  notification_email: '[email protected]'
        '401':
          description: 'Unauthorized — missing or invalid `Authorization: Token token=...` header.'
    delete:
      operationId: deleteCouponLists
      summary: Delete — Coupon lists
      tags:
      - Coupon Lists
      externalDocs:
        description: Cendyn CRM API reference
        url: https://developers.cendyncrm.com/api/docs/coupons/delete
      parameters:
      - name: account_id
        in: path
        required: true
        schema:
          type: string
        description: Your account unique identifier to access API.
      - name: coupon_list_id
        in: path
        required: true
        schema:
          type: string
        description: Id of coupon list
      responses:
        '200':
          description: Successful response
          content:
            application/json:
              example:
                coupon_list:
                  _id: 5853d8c2edb7aacab9000045
                  name: Coupon list
                  total_coupons: 2
                  used_coupons: 0
                  pending_coupons: 2
                  redeem_coupons: 0
                  low_limit_notification: 10
                  notification_email: '[email protected]'
        '401':
          description: 'Unauthorized — missing or invalid `Authorization: Token token=...` header.'
  /v2/account/{account_id}/coupon_lists/redeem:
    put:
      operationId: redeemCouponLists
      summary: Redeem — Coupon lists
      tags:
      - Coupon Lists
      externalDocs:
        description: Cendyn CRM API reference
        url: https://developers.cendyncrm.com/api/docs/coupons/redeem
      parameters:
      - name: account_id
        in: path
        required: true
        schema:
          type: string
        description: Your account unique identifier to access API.
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                code:
                  description: Coupon code redeemed
                contact_id:
                  description: Contact ID
                campaign_id:
                  description: Campaign ID
              required:
              - code
            example:
              code: code_4
              contact_id: ':contact_id:'
              campaign_id: ':campaign_id:'
      responses:
        '200':
          description: Successful response
          content:
            application/json:
              example:
                coupon_list:
                  _id: 5853d8c2edb7aacab9000045
                  name: Coupon list
                  total_coupons: 2
                  used_coupons: 0
                  pending_coupons: 1
                  redeem_coupons: 1
                  low_limit_notification: 10
                  notification_email: '[email protected]'
        '401':
          description: 'Unauthorized — missing or invalid `Authorization: Token token=...` header.'
components:
  securitySchemes:
    accountToken:
      type: apiKey
      in: header
      name: Authorization
      description: 'Account token authentication. Send `Authorization: Token token={account.secret}`. Some operations require the account master secret (`Token token={account.master_secret}`).'
externalDocs:
  description: Cendyn CRM Developers Central
  url: https://developers.cendyncrm.com/api