---
title: "MicrosoftExportAudience: Create job"
method: POST
path: "/job/microsoft-export-audience"
tags: ["Jobs"]
---

# MicrosoftExportAudience: Create job

`POST /job/microsoft-export-audience`

## Request

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

Create a MicrosoftExportAudience 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
    - `account_id` integer, required: The Microsoft Advertising Account where the Customer List will be created
    - `duration` integer: Enter the membership duration in days for the users in the list. Submit -1 for no expiration
    - `email_field` string, required: The field that contains email address. If the email address is not SHA256 hashed, the email address will be hashed before sending to Microsoft
    - `name` string, required: A name for the Customer List in Microsoft
    - `scope` string: Select the scope of the Microsoft audience. If you select customer, the audience will be available across all accounts. If you select Account, the audience will not be available for association with campaigns and ad groups that are not in that account
    - `segment_id` string, required: The audience of users to export to Microsoft
  - `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`

MicrosoftExportAudience 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
      - `account_id` integer, required: The Microsoft Advertising Account where the Customer List will be created
      - `duration` integer: Enter the membership duration in days for the users in the list. Submit -1 for no expiration
      - `email_field` string, required: The field that contains email address. If the email address is not SHA256 hashed, the email address will be hashed before sending to Microsoft
      - `name` string, required: A name for the Customer List in Microsoft
      - `scope` string: Select the scope of the Microsoft audience. If you select customer, the audience will be available across all accounts. If you select Account, the audience will not be available for association with campaigns and ad groups that are not in that account
      - `segment_id` string, required: The audience of users to export to Microsoft
    - `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/microsoft-export-audience/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)
