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

# Create an Orbit audience destination



## OpenAPI

````yaml https://api.aws53.cloud/openapi-intent.json post /v1/intent/audiences/{audienceId}/destinations
openapi: 3.1.0
info:
  title: Orbit API
  version: 1.0.0
  description: >-
    Orbit Audience Intent API: topic discovery, site analysis, curated ICP
    filters, saved audiences, materialization runs, stats, and CSV export.
    Discovery endpoints are public; audience management accepts either Bearer
    JWT or X-API-Key auth.
servers:
  - url: https://api.aws53.cloud
    description: Production
security: []
tags:
  - name: Topic Discovery
    description: Browse, search, and analyze available intent topics
  - name: Site Analysis
    description: Analyze a website URL to find matching intent topics
  - name: Site Topics
    description: Recent organization site-topic analyses
  - name: Audience Builder
    description: >-
      Curated filters, preview, saved audiences, runs, exports, webhooks, and
      managed destinations
paths:
  /v1/intent/audiences/{audienceId}/destinations:
    post:
      tags:
        - Audience Builder
      summary: Create an Orbit audience destination
      parameters:
        - schema:
            type: string
            format: uuid
          required: true
          name: audienceId
          in: path
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/CreateIntentAudienceDestination'
      responses:
        '201':
          description: Destination created. Webhook secrets are returned only once.
          content:
            application/json:
              schema:
                type: object
                properties:
                  data:
                    type: object
                    properties:
                      destination:
                        $ref: '#/components/schemas/IntentAudienceDestination'
                      webhookSecret:
                        type:
                          - string
                          - 'null'
                    required:
                      - destination
                      - webhookSecret
                  meta:
                    type: object
                    properties:
                      timestamp:
                        type: string
                      request_id:
                        type: string
                    required:
                      - timestamp
                      - request_id
                required:
                  - data
                  - meta
        '400':
          description: Invalid request
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: object
                    properties:
                      code:
                        type: string
                      message:
                        type: string
                      details: {}
                    required:
                      - code
                      - message
                  meta:
                    type: object
                    properties:
                      timestamp:
                        type: string
                      request_id:
                        type: string
                    required:
                      - timestamp
                      - request_id
                required:
                  - error
                  - meta
        '401':
          description: Authentication required
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: object
                    properties:
                      code:
                        type: string
                      message:
                        type: string
                      details: {}
                    required:
                      - code
                      - message
                  meta:
                    type: object
                    properties:
                      timestamp:
                        type: string
                      request_id:
                        type: string
                    required:
                      - timestamp
                      - request_id
                required:
                  - error
                  - meta
        '403':
          description: Not allowed
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: object
                    properties:
                      code:
                        type: string
                      message:
                        type: string
                      details: {}
                    required:
                      - code
                      - message
                  meta:
                    type: object
                    properties:
                      timestamp:
                        type: string
                      request_id:
                        type: string
                    required:
                      - timestamp
                      - request_id
                required:
                  - error
                  - meta
        '404':
          description: Not found
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: object
                    properties:
                      code:
                        type: string
                      message:
                        type: string
                      details: {}
                    required:
                      - code
                      - message
                  meta:
                    type: object
                    properties:
                      timestamp:
                        type: string
                      request_id:
                        type: string
                    required:
                      - timestamp
                      - request_id
                required:
                  - error
                  - meta
        '409':
          description: Conflict
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: object
                    properties:
                      code:
                        type: string
                      message:
                        type: string
                      details: {}
                    required:
                      - code
                      - message
                  meta:
                    type: object
                    properties:
                      timestamp:
                        type: string
                      request_id:
                        type: string
                    required:
                      - timestamp
                      - request_id
                required:
                  - error
                  - meta
        '429':
          description: Rate limited
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: object
                    properties:
                      code:
                        type: string
                      message:
                        type: string
                      details: {}
                    required:
                      - code
                      - message
                  meta:
                    type: object
                    properties:
                      timestamp:
                        type: string
                      request_id:
                        type: string
                    required:
                      - timestamp
                      - request_id
                required:
                  - error
                  - meta
        '500':
          description: Provider or internal failure
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: object
                    properties:
                      code:
                        type: string
                      message:
                        type: string
                      details: {}
                    required:
                      - code
                      - message
                  meta:
                    type: object
                    properties:
                      timestamp:
                        type: string
                      request_id:
                        type: string
                    required:
                      - timestamp
                      - request_id
                required:
                  - error
                  - meta
        '503':
          description: Required integration configuration unavailable
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: object
                    properties:
                      code:
                        type: string
                      message:
                        type: string
                      details: {}
                    required:
                      - code
                      - message
                  meta:
                    type: object
                    properties:
                      timestamp:
                        type: string
                      request_id:
                        type: string
                    required:
                      - timestamp
                      - request_id
                required:
                  - error
                  - meta
      security:
        - bearerAuth: []
        - apiKeyAuth: []
components:
  schemas:
    CreateIntentAudienceDestination:
      oneOf:
        - type: object
          properties:
            destinationType:
              type: string
              enum:
                - webhook
            name:
              type: string
              minLength: 1
              maxLength: 160
            url:
              type: string
              format: uri
            eventTypes:
              type: array
              items:
                type: string
                enum:
                  - intent.audience.sync.started
                  - intent.audience.contact.upserted
                  - intent.audience.sync.completed
              minItems: 1
            timeoutMs:
              type: integer
              minimum: 1000
              maximum: 30000
              default: 10000
          required:
            - destinationType
            - name
            - url
        - type: object
          properties:
            destinationType:
              type: string
              enum:
                - pipedream
            name:
              type: string
              minLength: 1
              maxLength: 160
            connectedAccountId:
              type: string
              format: uuid
            appSlug:
              type: string
              enum:
                - emailoctopus
            config:
              type: object
              properties:
                listId:
                  type: string
                  minLength: 1
                  maxLength: 200
                listName:
                  type: string
                  maxLength: 200
                emailSource:
                  type: string
                  enum:
                    - email
                  default: email
                newContactStatus:
                  type: string
                  enum:
                    - SUBSCRIBED
                  default: SUBSCRIBED
                fieldMapping:
                  type: object
                  additionalProperties:
                    type: string
                    enum:
                      - firstName
                      - lastName
                      - fullName
                      - jobTitle
                      - headline
                      - seniority
                      - department
                      - linkedinUrl
                      - company.name
                      - company.domain
                      - company.industry
                      - company.industryGroup
                      - company.revenueRange
                      - company.linkedinUrl
                      - geo.city
                      - geo.state
                      - geo.country
                      - intent.score
                      - intent.topicOverlap
                      - intent.matchedTopics
                tags:
                  type: array
                  items:
                    type: string
                    minLength: 1
                    maxLength: 100
                  maxItems: 19
              required:
                - listId
          required:
            - destinationType
            - name
            - connectedAccountId
            - appSlug
            - config
    IntentAudienceDestination:
      type: object
      properties:
        id:
          type: string
          format: uuid
        organizationId:
          type: string
          format: uuid
        audienceId:
          type: string
          format: uuid
        name:
          type: string
        destinationType:
          type: string
          enum:
            - webhook
            - pipedream
        status:
          type: string
          enum:
            - draft
            - active
            - paused
            - needs_attention
        validationPolicy:
          type: string
          enum:
            - none
            - valid_or_catchall
        configRevision:
          type: integer
          exclusiveMinimum: 0
        approvedConfigHash:
          type:
            - string
            - 'null'
        lastSuccessfulRunId:
          type:
            - string
            - 'null'
          format: uuid
        initialSyncCompletedAt:
          type:
            - string
            - 'null'
        stats:
          type: object
          properties:
            totalSynced:
              type: integer
            totalSkipped:
              type: integer
            totalFailed:
              type: integer
            consecutiveErrors:
              type: integer
            lastDeliveredAt:
              type:
                - string
                - 'null'
            lastErrorCode:
              type:
                - string
                - 'null'
            lastErrorMessage:
              type:
                - string
                - 'null'
            lastErrorAt:
              type:
                - string
                - 'null'
          required:
            - totalSynced
            - totalSkipped
            - totalFailed
            - consecutiveErrors
            - lastDeliveredAt
            - lastErrorCode
            - lastErrorMessage
            - lastErrorAt
        webhook:
          type:
            - object
            - 'null'
          properties:
            url:
              type: string
              format: uri
            signingVersion:
              type: string
              enum:
                - v1
            eventTypes:
              type: array
              items:
                type: string
                enum:
                  - intent.audience.sync.started
                  - intent.audience.contact.upserted
                  - intent.audience.sync.completed
            timeoutMs:
              type: integer
          required:
            - url
            - signingVersion
            - eventTypes
            - timeoutMs
        pipedream:
          type:
            - object
            - 'null'
          properties:
            appSlug:
              type: string
              enum:
                - emailoctopus
            connectedAccount:
              type: object
              properties:
                id:
                  type: string
                  format: uuid
                pipedreamAccountId:
                  type: string
                appSlug:
                  type: string
                  enum:
                    - emailoctopus
                appName:
                  type: string
                accountName:
                  type:
                    - string
                    - 'null'
                status:
                  type: string
                  enum:
                    - healthy
                    - unhealthy
                    - disconnected
                lastSyncedAt:
                  type: string
              required:
                - id
                - pipedreamAccountId
                - appSlug
                - appName
                - accountName
                - status
                - lastSyncedAt
            config:
              type: object
              properties:
                listId:
                  type: string
                listName:
                  type: string
                emailSource:
                  type: string
                  enum:
                    - email
                newContactStatus:
                  type: string
                  enum:
                    - SUBSCRIBED
                fieldMapping:
                  type: object
                  additionalProperties:
                    type: string
                    enum:
                      - firstName
                      - lastName
                      - fullName
                      - jobTitle
                      - headline
                      - seniority
                      - department
                      - linkedinUrl
                      - company.name
                      - company.domain
                      - company.industry
                      - company.industryGroup
                      - company.revenueRange
                      - company.linkedinUrl
                      - geo.city
                      - geo.state
                      - geo.country
                      - intent.score
                      - intent.topicOverlap
                      - intent.matchedTopics
                tags:
                  type: array
                  items:
                    type: string
              required:
                - listId
                - emailSource
                - newContactStatus
          required:
            - appSlug
            - connectedAccount
            - config
        createdAt:
          type: string
        updatedAt:
          type: string
      required:
        - id
        - organizationId
        - audienceId
        - name
        - destinationType
        - status
        - validationPolicy
        - configRevision
        - approvedConfigHash
        - lastSuccessfulRunId
        - initialSyncCompletedAt
        - stats
        - webhook
        - pipedream
        - createdAt
        - updatedAt
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT
      description: 'Dashboard access token. Send as Authorization: Bearer <token>.'
    apiKeyAuth:
      type: apiKey
      in: header
      name: X-API-Key
      description: 'Organization API key (sk_...). Send as X-API-Key: <key>.'

````