---
title: "PinterestCapiExport: Create job"
method: POST
path: "/job/pinterest-capi-export"
tags: ["Jobs"]
---

# PinterestCapiExport: Create job

`POST /job/pinterest-capi-export`

## Request

- Base URL: `https://api.lytics.io/v2`
- URL: `https://api.lytics.io/v2/job/pinterest-capi-export`
- Auth: API key in header `Authorization`

Create a PinterestCapiExport job

## Query parameters

- `account_id` string

## Request body `*/*`

- object
  - `auth_ids` string[]: Authorization IDs associated with the Job
  - `config` object, required: Job configuration, unique per-workflow
    - `action_source` 'app_android' | 'app_ios' | 'web' | 'offline': Select the action source for this conversion. If Action Source is not mapped or the user field is empty, this value will be used
    - `audience_events` 'enters_only' | 'exits_only': Select which type of audience trigger events to send to Pinterest. By default both enters and exits with be sent.
    - `event_name` 'add_to_cart' | 'checkout' | 'custom' | 'lead' | 'page_visit' | 'search' | 'signup' | 'view_category' | 'watch_video': Select the Event Name associated with this conversion. If Event Name is not mapped or the user field is empty, this value will be used
    - `field_changes` string[]: Select up to 75 user fields to trigger user change events. For any user in the exported audience, if any of the selected field values change, then the user field change event will be sent to the Pinterest API.
    - `identifier_mapping` object[], required: Map all the Identifier fields from Lytics to Pinterest by selecting the Lytics field on the left, and its Pinterest destination on the right
    - `mapping` object[]: Map all the other event fields from Lytics to Pinterest by selecting the Lytics field on the left, and its Pinterest destination on the right
    - `partner_name` string: Enter the partner name associated with these conversions. If Partner Name is not mapped, or the field is empty, this value will be used
    - `required_mapping` object[], required: Map all the required event fields from Lytics to Pinterest by selecting the Lytics field on the left, and its Pinterest destination on the right
    - `segment_id` string, required: Select the audience to export
    - `withbackfill` boolean: Add users who already exist in the selected Lytics audience
  - `description` string: A user-defined description
  - `drop_events_during_quiet_window` boolean
  - `expires_at` string, date-time
  - `monitoring` object: Inline monitoring config. On write: omit to keep, null to clear, or a config to set.
  - `name` string, required: A user-defined name
  - `quiet_period` integer
  - `quiet_time_of_day` string
  - `quiet_timezone` string

## Response `201`

PinterestCapiExport Job

- object
  - `_meta` object: Response Metadata
  - `data` object: Response Payload
    - `account_id` string: Lytics Account ID
    - `anomaly_rule` ModelsAnomalyRuleResp
      - `aid` integer
      - `checks` ModelsRuleCheckConfigReq[]
        - `allowable_violations` integer
        - `interval` string
        - `lookback_count` integer
        - `max_threshold` integer
        - `metric_type` string
        - `min_threshold` integer
        - `type` string
        - `variance_pct` number
      - `created` string
      - `id` string
      - `subject_id` string
      - `subject_type` string
      - `updated` string
    - `api_token_auth_id` string: this is set when work is create using access token
    - `auth_ids` string[]: Authorization IDs associated with the Job
    - `config` object, required: Job configuration, unique per-workflow
      - `action_source` 'app_android' | 'app_ios' | 'web' | 'offline': Select the action source for this conversion. If Action Source is not mapped or the user field is empty, this value will be used
      - `audience_events` 'enters_only' | 'exits_only': Select which type of audience trigger events to send to Pinterest. By default both enters and exits with be sent.
      - `event_name` 'add_to_cart' | 'checkout' | 'custom' | 'lead' | 'page_visit' | 'search' | 'signup' | 'view_category' | 'watch_video': Select the Event Name associated with this conversion. If Event Name is not mapped or the user field is empty, this value will be used
      - `field_changes` string[]: Select up to 75 user fields to trigger user change events. For any user in the exported audience, if any of the selected field values change, then the user field change event will be sent to the Pinterest API.
      - `identifier_mapping` object[], required: Map all the Identifier fields from Lytics to Pinterest by selecting the Lytics field on the left, and its Pinterest destination on the right
      - `mapping` object[]: Map all the other event fields from Lytics to Pinterest by selecting the Lytics field on the left, and its Pinterest destination on the right
      - `partner_name` string: Enter the partner name associated with these conversions. If Partner Name is not mapped, or the field is empty, this value will be used
      - `required_mapping` object[], required: Map all the required event fields from Lytics to Pinterest by selecting the Lytics field on the left, and its Pinterest destination on the right
      - `segment_id` string, required: Select the audience to export
      - `withbackfill` boolean: Add users who already exist in the selected Lytics audience
    - `created` string
    - `deleted` boolean: The Job has been deleted
    - `description` string: A user-defined description
    - `drop_events_during_quiet_window` boolean
    - `expires_at` string, date-time
    - `id` string: A Lytics-assigned, immutable unique ID for the Job
    - `meta` object: Extra meta data about the job
    - `monitoring` object: Inline monitoring config. On write: omit to keep, null to clear, or a config to set.
    - `name` string, required: A user-defined name
    - `quiet_period` integer
    - `quiet_time_of_day` string
    - `quiet_timezone` string
    - `sleep_until` string
    - `status` 'runnable' | 'sleeping' | 'paused' | 'completed' | 'fault' | 'failed' | 'killed' | 'deleted' | 'unknown': The status of the job
    - `updated` string
    - `user_id` string: The user ID that created or updated the job
    - `workflow` string: The workflow slug
    - `workflow_id` string: The workflow ID
  - `request_id` string
  - `status` integer: HTTP Status Code

## Other responses

- `404`: Not Found
- `500`: Internal Server Error

## Changes

- **2026-11-03** `d8e975057aec`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/lytics/apis/lytics-api/changes/job/pinterest-capi-export/post.md)

---

[API](https://skmtc.dev/lytics/apis/lytics-api.md) - [All operations](https://skmtc.dev/lytics/apis/lytics-api/llms.txt) - [OpenAPI document](https://skmtc.dev/lytics/apis/lytics-api/revisions/d8e975057aec?raw)