---
title: "Process a referral campaign request"
method: POST
path: "/api/servicereferral/processes/referralCampaigns"
tags: ["referralCampaigns"]
---

# Process a referral campaign request

`POST /api/servicereferral/processes/referralCampaigns`

## Request body

- object
  - `applicant` object
    - `email` string, required
    - `name` string, required
    - `first_name` string, required
    - `last_name` string, required
    - `phone_number` string, required
    - `normalized_phone_number` string, required
    - `phone_number_country_code` string, required
    - `data` object, required
    - `created_at` string, required
    - `id` string, required
    - `background_checks` union[], required
      - union
        - object
          - `status` 'clear' | 'consider' | 'negative' | 'non_negative' | 'complete' | 'pending' | 'suspended' | 'dispute' | 'canceled', required
          - `title` string, required
          - `updated_at` string, required
          - `candidate_id` string, required
          - `report_id` string, required
          - `vendor` 'checkr', required
        - object
          - `title` string, required
          - `applicant_id` string, required
          - `updated_at` string, required
          - `status` 'no bgc' | 'pending' | 'consented' | 'not consented' | 'clear' | 'consider' | 'withdrawn' | 'paused' | 'reopened', required
          - `check_id` string, required
          - `vendor` 'onfido', required
    - `work_availability` 'sunday_morning' | 'sunday_afternoon' | 'sunday_evening' | 'monday_morning' | 'monday_afternoon' | 'monday_evening' | 'tuesday_morning' | 'tuesday_afternoon' | 'tuesday_evening' | 'wednesday_morning' | 'wednesday_afternoon' | 'wednesday_evening' | 'thursday_morning' | 'thursday_afternoon' | 'thursday_evening' | 'friday_morning' | 'friday_afternoon' | 'friday_evening' | 'saturday_morning' | 'saturday_afternoon' | 'saturday_evening'
    - `date_of_birth` string
    - `funnel` object, required
      - `title` string, required
      - `custom_id` string, required
      - `id` string, required
      - `location` object
        - `name` string, required
        - `id` string, required
        - `latitude` number, required
        - `longitude` number, required
        - `location_group` object, required
          - `name` string, required
          - `id` string, required
      - `position` object
        - `name` string, required
        - `id` string, required
    - `stage` object, required
      - `title` string, required
      - `id` string, required
      - `parent_id` string, required
      - `type` string, required
    - `score_card_results` object[]
  - `utm_source` string
  - `utm_content` string
  - `utm_term` string
  - `utm_medium` string
  - `utm_campaign` string
  - `status` 'self_identified' | 'applied' | 'hired' | 'rejected'
  - `applicantSource` string

## Response `201`

Referral campaign request processed

- object
  - `meta` ResponsesPartMeta
    - `timestamp` string, date-time, required
    - `verb` 'OPTION' | 'GET' | 'PUT' | 'POST' | 'PATCH' | 'DELETE'
    - `path` string
    - `jti` string
    - `rid` string
    - `count` number
    - `status` string
    - `duration` number
    - `size` number
  - `success` boolean

---

[API](https://skmtc.net/fountain/apis/hire-public-api.md) · [All operations](https://skmtc.net/fountain/apis/hire-public-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/fountain/hire-public-api/revisions/5f406c0e9462/schema)