Push Audience List API

The Audience List API from Push — 2 operation(s) for audience list.

Operations 5

POST /v2/account/{account_id}/lists Create — Audience List #
GET /v2/account/{account_id}/lists List — Audience List #
GET /v2/account/{account_id}/lists/{id} Show — Audience List #
PUT /v2/account/{account_id}/lists/{id} Update — Audience List #
DELETE /v2/account/{account_id}/lists/{id} Delete — Audience List #

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-audience-list-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.

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

OpenAPI Specification

push-audience-list-api-openapi.yml Raw ↑
openapi: 3.2.0
info:
  title: Cendyn CRM (PUSHTech) REST Audience List 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: Audience List
paths:
  /v2/account/{account_id}/lists:
    post:
      operationId: createAudienceList
      summary: Create — Audience List
      tags:
      - Audience List
      externalDocs:
        description: Cendyn CRM API reference
        url: https://developers.cendyncrm.com/api/docs/list/create
      parameters:
      - name: account_id
        in: path
        required: true
        schema:
          type: string
        description: Account unique identifier
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                name:
                  description: Name of the list
                description:
                  description: Description of the list
                visibility:
                  description: Visibility of the list
              required:
              - name
            example:
              name: Project Ideas
              description: List of project ideas
              visibility: public
      responses:
        '201':
          description: Successful response
          content:
            application/json:
              example:
                id: new_list_id
                name: Project Ideas
                description: List of project ideas
                visibility: public
        '401':
          description: 'Unauthorized — missing or invalid `Authorization: Token token=...` header.'
    get:
      operationId: listAudienceList
      summary: List — Audience List
      tags:
      - Audience List
      externalDocs:
        description: Cendyn CRM API reference
        url: https://developers.cendyncrm.com/api/docs/list/list
      parameters:
      - name: account_id
        in: path
        required: true
        schema:
          type: string
        description: Account unique identifier
      responses:
        '200':
          description: Successful response
          content:
            application/json:
              example:
                lists:
                - id: list1_id
                  name: First List
                  description: Description of the first list
                  created_at: '2024-04-17T12:00:00Z'
                  visibility: public
                - id: list2_id
                  name: Second List
                  description: Description of the second list
                  created_at: '2024-04-17T12:00:00Z'
                  visibility: private
        '401':
          description: 'Unauthorized — missing or invalid `Authorization: Token token=...` header.'
  /v2/account/{account_id}/lists/{id}:
    get:
      operationId: showAudienceList
      summary: Show — Audience List
      tags:
      - Audience List
      externalDocs:
        description: Cendyn CRM API reference
        url: https://developers.cendyncrm.com/api/docs/list/show
      parameters:
      - name: account_id
        in: path
        required: true
        schema:
          type: string
        description: Account unique identifier
      - name: id
        in: path
        required: true
        schema:
          type: string
        description: List unique identifier
      responses:
        '200':
          description: Successful response
          content:
            application/json:
              example:
                id: list1_id
                name: First List
                description: Description of the first list
                created_at: '2024-04-17T12:00:00Z'
                visibility: public
        '401':
          description: 'Unauthorized — missing or invalid `Authorization: Token token=...` header.'
    put:
      operationId: updateAudienceList
      summary: Update — Audience List
      tags:
      - Audience List
      externalDocs:
        description: Cendyn CRM API reference
        url: https://developers.cendyncrm.com/api/docs/list/update
      parameters:
      - name: account_id
        in: path
        required: true
        schema:
          type: string
        description: Account unique identifier
      - name: id
        in: path
        required: true
        schema:
          type: string
        description: List unique identifier
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                name:
                  description: Name of the list
                description:
                  description: Description of the list
                visibility:
                  description: Visibility of the list
            example:
              name: Updated List
              description: Updated description
              visibility: private
      responses:
        '200':
          description: Successful response
          content:
            application/json:
              example:
                id: updated_list_id
                name: Updated List
                description: Updated description
                visibility: private
        '401':
          description: 'Unauthorized — missing or invalid `Authorization: Token token=...` header.'
    delete:
      operationId: deleteAudienceList
      summary: Delete — Audience List
      tags:
      - Audience List
      externalDocs:
        description: Cendyn CRM API reference
        url: https://developers.cendyncrm.com/api/docs/list/delete
      parameters:
      - name: account_id
        in: path
        required: true
        schema:
          type: string
        description: Account unique identifier
      - name: id
        in: path
        required: true
        schema:
          type: string
        description: List unique identifier
      responses:
        '200':
          description: Successful response
          content:
            application/json:
              example:
                message: List successfully deleted
        '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