Call2Me Notifications API

The Notifications API from Call2Me — 3 operation(s) for notifications.

Operations 5

GET /v1/agents/{agent_id}/notifications List Targets #
POST /v1/agents/{agent_id}/notifications Create Target #
PATCH /v1/notifications/{target_id} Update Target #
DELETE /v1/notifications/{target_id} Delete Target #
GET /v1/calls/{call_id}/deliveries List Deliveries #

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/call2me-app:call2me-app-notifications-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"

Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.

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

call2me-app-notifications-api-openapi.yml Raw ↑
openapi: 3.2.0
info:
  title: Call2Me Notifications API
  description: '# Call2Me Voice AI Platform API


    Programmatic interface to build, deploy and operate voice AI agents that can place

    and receive phone calls in real time. Designed to be consumed by humans **and** by

    AI agent frameworks (function-calling LLMs, MCP servers, automation platforms like

    Composio, Pipedream, Zapier, n8n).


    ## What you can do


    - **Place outbound calls** — give an agent a phone number to dial; the AI handles

    the conversation end-to-end and returns a transcript + recording.

    - **Manage AI agents** — create personalities, attach voices, system prompts,

    knowledge bases and post-call actions.

    - **Schedule calls** — one-shot or recurring (cron-like) outbound calls.

    - **Knowledge base (RAG)** — upload documents/URLs so the agent answers from your

    data with reduced hallucination.

    - **Inbound** — provision phone numbers that route to your agents.


    ## Common LLM tool-calling use cases


    | Goal | Endpoint |

    |------|----------|

    | "Call this person and read them this script" | `POST /v1/calls` |

    | "Schedule a follow-up tomorrow at 14:00" | `POST /v1/schedules` |

    | "Get the transcript of last call" | `GET /v1/calls/{id}` |

    | "Add this PDF to the agent''s brain" | `POST /v1/knowledge-base/{id}/sources` |


    ## Authentication


    Every request requires a Bearer token issued from the dashboard:


    ```

    Authorization: Bearer c2m_sk_xxxxxxxxxxxxxxxx

    ```


    Get your API key from the API Keys page.

    Keys are scoped per-workspace and can be rotated/revoked any time.


    ## Rate Limits


    | Plan | Requests/min | Concurrent Calls |

    |------|-------------|------------------|

    | Free | 60 | 1 |

    | Pro | 600 | 10 |

    | Enterprise | Unlimited | Unlimited |


    ## SDKs & Integrations


    - Python SDK

    - Node.js SDK

    - OpenAPI 3.1 spec: `/openapi.json` (use it to generate clients or register the

    service with AI tool platforms)


    ## Support


    - Email: support@call2me.app

    - Docs: https://docs.call2me.app

    - Discord: https://discord.gg/call2me'
  version: 1.0.0
  x-logo:
    url: https://call2me.app/logo.png
    altText: Call2Me Logo
  contact:
    name: Call2Me Support
    url: https://call2me.app/support
    email: support@call2me.app
  license:
    name: Commercial — see Terms of Service
    url: https://call2me.app/terms
  termsOfService: https://call2me.app/terms
servers:
- url: https://api.call2me.app
  description: Production
- url: http://localhost:8000
  description: Local Development
security:
- BearerAuth: []
tags:
- name: Notifications
paths:
  /v1/agents/{agent_id}/notifications:
    get:
      tags:
      - Notifications
      summary: List Targets
      operationId: list_targets_v1_agents__agent_id__notifications_get
      parameters:
      - name: agent_id
        in: path
        required: true
        schema:
          type: string
          title: Agent Id
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/NotificationTarget'
                title: Response List Targets V1 Agents  Agent Id  Notifications Get
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
    post:
      tags:
      - Notifications
      summary: Create Target
      operationId: create_target_v1_agents__agent_id__notifications_post
      parameters:
      - name: agent_id
        in: path
        required: true
        schema:
          type: string
          title: Agent Id
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/TargetCreate'
      responses:
        '201':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/NotificationTarget'
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /v1/notifications/{target_id}:
    patch:
      tags:
      - Notifications
      summary: Update Target
      operationId: update_target_v1_notifications__target_id__patch
      parameters:
      - name: target_id
        in: path
        required: true
        schema:
          type: string
          title: Target Id
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/TargetUpdate'
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/NotificationTarget'
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
    delete:
      tags:
      - Notifications
      summary: Delete Target
      operationId: delete_target_v1_notifications__target_id__delete
      parameters:
      - name: target_id
        in: path
        required: true
        schema:
          type: string
          title: Target Id
      responses:
        '204':
          description: Successful Response
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /v1/calls/{call_id}/deliveries:
    get:
      tags:
      - Notifications
      summary: List Deliveries
      operationId: list_deliveries_v1_calls__call_id__deliveries_get
      parameters:
      - name: call_id
        in: path
        required: true
        schema:
          type: string
          title: Call Id
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
components:
  schemas:
    ValidationError:
      properties:
        loc:
          items:
            anyOf:
            - type: string
            - type: integer
          type: array
          title: Location
        msg:
          type: string
          title: Message
        type:
          type: string
          title: Error Type
        input:
          title: Input
        ctx:
          type: object
          title: Context
      type: object
      required:
      - loc
      - msg
      - type
      title: ValidationError
    TargetCreate:
      properties:
        channel:
          type: string
          enum:
          - whatsapp
          - sms
          - email
          - custom_url
          title: Channel
        destination:
          anyOf:
          - type: string
          - type: 'null'
          title: Destination
        recipient_kind:
          type: string
          enum:
          - owner
          - caller
          - fixed
          - team
          title: Recipient Kind
          default: fixed
        trigger_event:
          type: string
          enum:
          - call_ended
          - chat_ended
          title: Trigger Event
          default: call_ended
        condition:
          additionalProperties: true
          type: object
          title: Condition
        template:
          anyOf:
          - type: string
          - type: 'null'
          title: Template
        template_vars:
          additionalProperties: true
          type: object
          title: Template Vars
        active:
          type: boolean
          title: Active
          default: true
      type: object
      required:
      - channel
      title: TargetCreate
    NotificationTarget:
      properties:
        target_id:
          type: string
          title: Target Id
        agent_id:
          type: string
          title: Agent Id
        user_id:
          type: string
          title: User Id
        trigger_event:
          type: string
          enum:
          - call_ended
          - chat_ended
          title: Trigger Event
          default: call_ended
        channel:
          type: string
          enum:
          - whatsapp
          - sms
          - email
          - custom_url
          title: Channel
        destination:
          anyOf:
          - type: string
          - type: 'null'
          title: Destination
        recipient_kind:
          type: string
          enum:
          - owner
          - caller
          - fixed
          - team
          title: Recipient Kind
          default: fixed
        condition:
          additionalProperties: true
          type: object
          title: Condition
        template:
          anyOf:
          - type: string
          - type: 'null'
          title: Template
        template_vars:
          additionalProperties: true
          type: object
          title: Template Vars
        active:
          type: boolean
          title: Active
          default: true
        created_at:
          anyOf:
          - type: string
            format: date-time
          - type: 'null'
          title: Created At
        updated_at:
          anyOf:
          - type: string
            format: date-time
          - type: 'null'
          title: Updated At
      type: object
      required:
      - target_id
      - agent_id
      - user_id
      - channel
      title: NotificationTarget
      description: Bir agent'ın çağrı/chat sonrası çıkış kuralı.
    TargetUpdate:
      properties:
        channel:
          anyOf:
          - type: string
            enum:
            - whatsapp
            - sms
            - email
            - custom_url
          - type: 'null'
          title: Channel
        destination:
          anyOf:
          - type: string
          - type: 'null'
          title: Destination
        recipient_kind:
          anyOf:
          - type: string
            enum:
            - owner
            - caller
            - fixed
            - team
          - type: 'null'
          title: Recipient Kind
        trigger_event:
          anyOf:
          - type: string
            enum:
            - call_ended
            - chat_ended
          - type: 'null'
          title: Trigger Event
        condition:
          anyOf:
          - additionalProperties: true
            type: object
          - type: 'null'
          title: Condition
        template:
          anyOf:
          - type: string
          - type: 'null'
          title: Template
        template_vars:
          anyOf:
          - additionalProperties: true
            type: object
          - type: 'null'
          title: Template Vars
        active:
          anyOf:
          - type: boolean
          - type: 'null'
          title: Active
      type: object
      title: TargetUpdate
    HTTPValidationError:
      properties:
        detail:
          items:
            $ref: '#/components/schemas/ValidationError'
          type: array
          title: Detail
      type: object
      title: HTTPValidationError
  securitySchemes:
    BearerAuth:
      type: http
      scheme: bearer
      bearerFormat: API Key
      description: Enter your API key
externalDocs:
  description: Full developer documentation
  url: https://docs.call2me.app