crispy-sh API

openapi: 3.1.0
info:
  title: crispy-sh API
  version: '2026-10-30'
  description: 'GENERATED FROM DOCUMENTATION by API Evangelist on 2026-10-30: 4 operation(s) read from 7 public documentation page(s) (each operation
    names its page in x-source). This is not the provider''s published contract; crispy-sh has published no machine-readable contract that the
    pipeline could find. Engine: anthropic.'
  x-evidence-tiers:
    code-example: 4
    documentation: 0
    pages-with-code: 6
    pages-read: 7
  x-generated-from: documentation
  x-provenance: generated
  x-authored-by: API Evangelist
  x-generated: '2026-10-30'
  x-generator: generate-contract-from-docs.py
  x-engine: anthropic
  x-sources:
  - https://crispy.sh/docs/reference
  - https://crispy.sh/docs/integrations/invitation-not-accepted-after
  - https://crispy.sh/docs/integrations
  - https://crispy.sh/docs/integrations/contact-first-inbound-message
  - https://crispy.sh/docs/integrations/company-contact-replied
  - https://crispy.sh/docs/integrations/lemlist-migration
  - https://crispy.sh/docs/integrations/dynamic-campaign-pause
paths:
  /api/mcp:
    post:
      operationId: post_api_mcp
      tags:
      - Api
      summary: POST /api/mcp
      x-source: https://crispy.sh/docs/reference
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PostApiMcpRequest'
      responses:
        '201':
          description: Success (status as documented)
      x-evidence:
        kind: code-example
        language: curl
        snippet: "curl -X POST https://crispy.sh/api/mcp  -H \"Authorization: Bearer YOUR_API_KEY\"  -H \"Content-Type: application/json\"  -d\
          \ '{\n \"jsonrpc\": \"2.0\",\n \"id\": 1,\n \"method\": \"tools/call\",\n \"params\": {\n \"name\": \"search_people\",\n \"arguments\"\
          : {\n \"keyword\": \"VP Engineering\",\n \"limit\": 5\n }\n }\n }' Documented tools (166) Your API key's permission scope determines\
          \ which tools can run. Every tool accepts an option"
  /api/v1/campaigns/$CAMPAIGN_ID/outreach/pause:
    post:
      operationId: post_api_v1_campaigns_CAMPAIGN_ID_outreach_pause
      tags:
      - Api
      summary: POST /api/v1/campaigns/$CAMPAIGN_ID/outreach/pause
      x-source: https://crispy.sh/docs/integrations/dynamic-campaign-pause
      responses:
        '201':
          description: Success (status as documented)
      x-evidence:
        kind: code-example
        language: curl
        snippet: 'curl -sS -X POST  -H "Authorization: Bearer $API_KEY"  "https://crispy.sh/api/v1/campaigns/$CAMPAIGN_ID/outreach/pause"

          fi Add to crontab: 0 9 * * * /usr/local/bin/pause-cold-campaign.sh runs daily at 09:00. The n8n version Same logic, no shell box needed:
          1. Schedule Trigger → daily at 09:00 UTC

          2. HTTP Request (GET) → https://crispy.sh/api/v1/campaigns/{{$env.CAMPAIGN_ID}}/state

          3. Code (JavaScr'
  /api/v1/campaigns/$CAMPAIGN_ID/state:
    get:
      operationId: get_api_v1_campaigns_CAMPAIGN_ID_state
      tags:
      - Api
      summary: GET /api/v1/campaigns/$CAMPAIGN_ID/state
      x-source: https://crispy.sh/docs/integrations/dynamic-campaign-pause
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: code-example
        language: curl
        snippet: "curl -sS  -H \"Authorization: Bearer $API_KEY\"  \"https://crispy.sh/api/v1/campaigns/$CAMPAIGN_ID/state\")\nSENT=$(echo \"\
          $STATE\" | jq -r '.state.data.funnel.sent //0')\nRATE=$(echo \"$STATE\" | jq -r '.state.data.funnel.accept_rate //0')\nif [ \"$SENT\"\
          \ -lt 30 ]; then\n echo \"Skipping: only $SENT invites sent so far (need >=30 for a stable rate)\"\n exit 0\nfi"
  /api/v1/subscriptions:
    post:
      operationId: post_api_v1_subscriptions
      tags:
      - Api
      summary: POST /api/v1/subscriptions
      x-source: https://crispy.sh/docs/integrations/invitation-not-accepted-after
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PostApiV1SubscriptionsRequest'
      responses:
        '201':
          description: Success (status as documented)
      x-evidence:
        kind: code-example
        language: curl
        snippet: "curl -X POST https://crispy.sh/api/v1/subscriptions  -H \"Authorization: Bearer crispy_your_api_key\"  -H \"Content-Type: application/json\"\
          \  -d '{\n \"event\": \"invitation.not_accepted_after\",\n \"target_url\": \"https://hook.us2.make.com/your-make-webhook-id\",\n \"\
          filter\": {\n \"is_first\": true,\n \"match\": {\n \"custom_attrs.industry\": \"SaaS\"\n }\n }\n }' Send a test invitation from Crispy\
          \ to fire a sample delivery."
components:
  schemas:
    PostApiMcpRequest:
      type: object
      properties:
        jsonrpc:
          type: string
        id:
          type: integer
        method:
          type: string
        params:
          type: object
          properties:
            name:
              type: string
            arguments:
              type: object
              properties:
                keyword:
                  type: string
                limit:
                  type: integer
    PostApiV1SubscriptionsRequest:
      type: object
      properties:
        event:
          type: string
        target_url:
          type: string
        filter:
          type: object
          properties:
            is_first:
              type: boolean
            match:
              type: object
              properties:
                custom_attrs.industry:
                  type: string
  securitySchemes:
    bearer:
      type: http
      scheme: bearer
security:
- bearer: []
tags:
- name: Api