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

# Set the prospect source

> **Destructive.** It sends, publishes, launches or deletes. Get a person to confirm before calling it.

Point a DRAFTED campaign at where its prospects come from: a LinkedIn/Sales Navigator search URL, a group, an event, a post, or a CRM segment. For an ACTIVE campaign use `campaign_add_prospects` instead — that adds to the existing pool rather than replacing the source.



## OpenAPI

````yaml /api-v2/openapi.json post /campaign_set_source
openapi: 3.1.0
info:
  title: LinkedCamp API
  version: 2.0.0
  description: >-
    Version 2 of the LinkedCamp API. Every endpoint is a POST to `/{endpoint}`
    with its arguments as a JSON object, and returns JSON.
servers:
  - url: https://api.linkedcamp.com/v2
security:
  - ApiKey: []
  - Bearer: []
tags:
  - name: Account
  - name: Notifications
  - name: Reference
  - name: Campaigns
  - name: Campaign audience
  - name: Sequences
  - name: Blocked dates
  - name: Leads
  - name: Lead notes
  - name: Activities
  - name: Tags
  - name: Blacklist
  - name: Conversations
  - name: Messages
  - name: Saved replies
  - name: Templates
  - name: Merge fields
  - name: Personalised images
  - name: LinkedIn accounts
  - name: Email accounts
  - name: AI agents
  - name: Knowledge base
  - name: Personas
  - name: Analytics
  - name: Posts
  - name: Posting schedule
  - name: Tasks
  - name: Appointments
  - name: Reminders
  - name: Automations
paths:
  /campaign_set_source:
    post:
      tags:
        - Campaign audience
      summary: Set the prospect source
      description: >-
        **Destructive.** It sends, publishes, launches or deletes. Get a person
        to confirm before calling it.


        Point a DRAFTED campaign at where its prospects come from: a
        LinkedIn/Sales Navigator search URL, a group, an event, a post, or a CRM
        segment. For an ACTIVE campaign use `campaign_add_prospects` instead —
        that adds to the existing pool rather than replacing the source.
      operationId: campaign_set_source
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                campaignId:
                  type: string
                  description: Campaign id, from `campaign_list` or `campaign_create`.
                url:
                  type: string
                  description: >-
                    A LinkedIn LIST url — a basic search, a Sales Navigator
                    (`/sales/`) search, a Recruiter (`/talent/`) search, or a
                    group / event / post. Not a single profile. Required unless
                    using a CRM source.
                surface:
                  type: string
                  enum:
                    - sales-navigator
                    - recruiter
                    - basic
                  description: >-
                    Assert which LinkedIn surface the url belongs to. The call
                    is rejected if the url does not match, the same way the web
                    app validates its Sales Navigator and Recruiter tabs. Omit
                    to detect it.
                type:
                  type: string
                  enum:
                    - url
                    - event
                    - group
                    - post
                    - marketplace
                    - csv
                    - hubspot
                    - ghl
                    - api
                  description: >-
                    Override the inferred source type. Use "hubspot" or "ghl"
                    for CRM pulls.
                field:
                  type: string
                  description: >-
                    CRM sources: the contact property holding the LinkedIn
                    profile URL.
                query:
                  type: string
                  description: 'CRM sources: the segment / list / filter query to pull.'
              required:
                - campaignId
              additionalProperties: false
      responses:
        '200':
          description: >-
            The result, as JSON. Writes answer `{ "ok": true, "message": ...,
            "data": ... }`.
          content:
            application/json:
              schema:
                type: object
                additionalProperties: true
        '400':
          description: >-
            The body is not valid JSON, an argument is invalid, or the request
            was refused.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '401':
          description: No API key, or the key was rejected.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '403':
          description: >-
            Your plan, permissions or access tier don't include this, or a
            record belongs to another account.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '404':
          description: A record named in the arguments does not exist.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '422':
          description: >-
            The request was valid but the operation was refused, such as
            launching a campaign that is not ready.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '502':
          description: The service failed or could not be reached. Reads are safe to retry.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '504':
          description: >-
            The operation timed out. A write may still complete; read it back
            before retrying.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
components:
  schemas:
    Error:
      type: object
      required:
        - error
      properties:
        error:
          type: object
          required:
            - code
            - message
          properties:
            code:
              type: string
              enum:
                - UNAUTHENTICATED
                - FORBIDDEN
                - PLAN_REQUIRED
                - VALIDATION
                - INVALID_JSON
                - NOT_FOUND
                - METHOD_NOT_ALLOWED
                - UPSTREAM
                - TOOL_ERROR
            message:
              type: string
            hint:
              type: string
              description: What to do about it, when there is something to do.
  securitySchemes:
    ApiKey:
      type: apiKey
      in: header
      name: X-Api-Key
      description: Your LinkedCamp API key.
    Bearer:
      type: http
      scheme: bearer
      description: Your LinkedCamp API key as a bearer token.

````

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