> ## Documentation Index
> Fetch the complete documentation index at: https://docs.userecord.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Pause a campaign

> Stop everything still to go out (invites, follow-ups, SMS, calls) until you resume. Only a live campaign can be paused, and one whose candidates have all finished has nothing left to pause.

**Scope:** `enrichment:campaigns` · **Idempotency-Key:** optional



## OpenAPI

````yaml /enrichment-api/api-reference/openapi.json post /enrichments/{enrichment_id}/campaigns/{campaign_id}/pause
openapi: 3.1.0
info:
  title: Record Enrichment API
  version: 1.0.0
  description: >-
    Collect work, location, shift and salary details from your own candidate
    database. You need two things: your **key id** and your **secret**.
    Everything else is generated. See Authentication for how.
servers:
  - url: https://api-bc.userecord.io/api/v1/partner
    description: Enrichment API
security: []
tags:
  - name: Enrichments
  - name: Enrichment campaigns
  - name: Enrichment candidates
  - name: Enrichment results
  - name: Enrichment credits
paths:
  /enrichments/{enrichment_id}/campaigns/{campaign_id}/pause:
    post:
      tags:
        - Enrichment campaigns
      summary: Pause a campaign
      description: >-
        Stop everything still to go out (invites, follow-ups, SMS, calls) until
        you resume. Only a live campaign can be paused, and one whose candidates
        have all finished has nothing left to pause.


        **Scope:** `enrichment:campaigns` · **Idempotency-Key:** optional
      operationId: pauseEnrichmentCampaign
      parameters:
        - name: enrichment_id
          in: path
          required: true
          schema:
            type: string
            pattern: ^WF_[A-Z]{2}_[A-Z0-9]{10,40}$
          example: WF_EN_261121094822026AEDRUB86TQVSML
        - name: campaign_id
          in: path
          required: true
          schema:
            type: string
            pattern: ^EC_[A-Za-z0-9_-]{6,60}$
          example: EC_261121095438377TFUX07WN2XT42V
        - name: Idempotency-Key
          in: header
          required: false
          schema:
            type: string
            maxLength: 255
          description: >-
            Optional. A retry with the same key returns the first answer (kept
            24 h). Leave empty in Try it: a new one is made for every call.
      responses:
        '200':
          description: The campaign after the change
          content:
            application/json:
              schema:
                type: object
                properties:
                  success:
                    const: true
                    type: boolean
                  message:
                    type: string
                  data:
                    type: object
                    properties:
                      campaign_id:
                        type: string
                      enrichment_id:
                        type: string
                      name:
                        type: string
                      language:
                        type: string
                      status:
                        type: string
                        enum:
                          - sent
                          - paused
                          - completed
                          - cancelled
                        description: sent = live
                      awaiting_questions:
                        type: boolean
                        description: >-
                          true while the questions are still being prepared;
                          nothing goes out until they are
                      question_count:
                        type: integer
                      channels:
                        type: object
                        properties:
                          whatsapp:
                            type: boolean
                          voice_call:
                            type: boolean
                          sms:
                            type: boolean
                      rejected_count:
                        type: integer
                        description: Rows skipped at upload
                      created_at:
                        type: string
                      counts:
                        type: object
                        properties:
                          candidates:
                            type: integer
                          sent:
                            type: integer
                          completed:
                            type: integer
              example:
                success: true
                data:
                  campaign_id: EC_261121095438377TFUX07WN2XT42V
                  enrichment_id: WF_EN_261121094822026AEDRUB86TQVSML
                  name: November talent pool
                  language: english
                  status: paused
                  awaiting_questions: false
                  question_count: 2
                  channels:
                    whatsapp: true
                    voice_call: true
                    sms: true
                  rejected_count: 1
                  created_at: '2026-11-10T10:30:45.000Z'
                  counts:
                    candidates: 2
                    sent: 0
                    completed: 0
        '404':
          description: '`NOT_FOUND`: No such enrichment or campaign.'
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '409':
          description: >-
            `CONFLICT`: The campaign is not live, or every candidate has already
            finished.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
      security:
        - ApiKey: []
          SecretKey: []
      x-codeSamples:
        - lang: bash
          label: cURL
          source: >-
            pcall POST
            "/api/v1/partner/enrichments/WF_EN_261121094822026AEDRUB86TQVSML/campaigns/EC_261121095438377TFUX07WN2XT42V/pause"
        - lang: javascript
          label: JavaScript
          source: >-
            const res = await call("POST",
            "/api/v1/partner/enrichments/WF_EN_261121094822026AEDRUB86TQVSML/campaigns/EC_261121095438377TFUX07WN2XT42V/pause");

            const { data } = await res.json();
        - lang: python
          label: Python
          source: >-
            res = call("POST",
            "/api/v1/partner/enrichments/WF_EN_261121094822026AEDRUB86TQVSML/campaigns/EC_261121095438377TFUX07WN2XT42V/pause")

            data = res.json()["data"]
components:
  schemas:
    Error:
      type: object
      properties:
        success:
          const: false
          type: boolean
        error:
          type: object
          properties:
            code:
              type: string
              enum:
                - VALIDATION_FAILED
                - LIMIT_EXCEEDED
                - UNAUTHORIZED
                - SCOPE_MISSING
                - FORBIDDEN
                - HTTPS_REQUIRED
                - NOT_FOUND
                - CONFLICT
                - INSUFFICIENT_CREDITS
                - IDEMPOTENCY_KEY_REQUIRED
                - IDEMPOTENCY_KEY_REUSED
                - IDEMPOTENCY_IN_PROGRESS
                - PAYLOAD_TOO_LARGE
                - UNSUPPORTED_MEDIA_TYPE
                - RATE_LIMITED
                - COOLDOWN
                - DAILY_CAP
                - SERVICE_DISABLED
                - SERVER_ERROR
            message:
              type: string
            details:
              type: array
              items:
                type: object
                properties:
                  path:
                    type: string
                  message:
                    type: string
            request_id:
              type: string
              description: Quote it to Record support
  securitySchemes:
    ApiKey:
      type: apiKey
      in: header
      name: x-api-key
      description: Your key id, `VFN_TEST_…` or `VFN_LIVE_…`. Sent on every request.
    SecretKey:
      type: apiKey
      in: header
      name: x-secret-key
      description: >-
        Your secret, `VFN_SK_…`. **Not a real header, and never sent to the
        API.** It is only a form field for Try it, which uses it to sign your
        request in your browser. In your own code you sign each request with the
        secret and send `x-api-key`, `x-timestamp` and `x-signature` (see
        Authentication).

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.