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

# Create a LinkedIn campaign group

> Creates a campaign group for a connected LinkedIn account. New groups use a safe non-active status unless ACTIVE is explicit.



## OpenAPI

````yaml /openapi.json post /platform/{storeUrl}/actions/create-linkedin-campaign
openapi: 3.1.0
info:
  title: Bily API
  version: 1.0.0
  description: >-
    Discover stores, read analytics and commerce data, inspect connections, and
    run explicitly authorized actions with the Bily API.
  contact:
    name: Bily support
    email: support@bily.ai
servers:
  - url: https://app.bily.ai/api/customer/v1
    description: Production
security:
  - ApiKeyAuth: []
  - BearerAuth: []
tags:
  - name: Identity
    description: Discover the identity and organizations attached to a key.
  - name: Stores
    description: Discover stores within an organization.
  - name: Store data
    description: Read store profiles, readiness, catalogs, and connected accounts.
  - name: Commerce
    description: Run scoped commerce reads and explicitly approved GraphQL mutations.
  - name: Analytics
    description: >-
      Read normalized advertising, attribution, product, customer, and cohort
      metrics.
  - name: Analytics SQL
    description: Run constrained read-only SQL over store-scoped Bily datasets.
  - name: Customer journeys
    description: Read customer touchpoints within an authenticated store scope.
  - name: Connections
    description: Inspect available connections, support, and advertising assets.
  - name: Supported actions
    description: Synchronize connections and update supported advertising assets.
  - name: Campaign actions
    description: Create or clone supported advertising campaign resources.
  - name: Tracking connections
    description: >-
      List and manage store-scoped tracking connections without returning
      credential secrets.
paths:
  /platform/{storeUrl}/actions/create-linkedin-campaign:
    post:
      tags:
        - Campaign actions
      summary: Create a LinkedIn campaign group
      description: >-
        Creates a campaign group for a connected LinkedIn account. New groups
        use a safe non-active status unless ACTIVE is explicit.
      operationId: createLinkedInCampaign
      parameters:
        - $ref: '#/components/parameters/StoreUrl'
        - $ref: '#/components/parameters/OrganizationId'
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/LinkedInCampaignRequest'
      responses:
        '200':
          description: Request completed successfully.
          headers:
            x-request-id:
              description: The request identifier selected or generated by Bily.
              schema:
                type: string
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ActionResponse'
        '400':
          $ref: '#/components/responses/BadRequest'
        '401':
          $ref: '#/components/responses/Unauthorized'
        '403':
          $ref: '#/components/responses/Forbidden'
        '404':
          $ref: '#/components/responses/NotFound'
        '500':
          $ref: '#/components/responses/ServerError'
components:
  parameters:
    StoreUrl:
      name: storeUrl
      in: path
      required: true
      description: The exact store URL returned by GET /context or GET /stores.
      schema:
        type: string
        example: store.example.com
    OrganizationId:
      name: x-bily-organization-id
      in: header
      required: false
      description: >-
        An organization ID returned by GET /context or GET /organizations.
        Required for GET /stores and optional for store-scoped paths.
      schema:
        type: string
        example: org_01J8W7T9G3E6ZQ4M2K5N8P1R0S
  schemas:
    LinkedInCampaignRequest:
      type: object
      required:
        - adAccountId
        - payload
      properties:
        adAccountId:
          type: string
        payload:
          type: object
          required:
            - name
          properties:
            name:
              type: string
            status:
              type: string
              enum:
                - ACTIVE
                - PAUSED
                - ARCHIVED
              default: PAUSED
            startTime:
              type: integer
              description: Start time as Unix milliseconds.
            endTime:
              type:
                - integer
                - 'null'
              description: End time as Unix milliseconds.
            budget:
              type: number
              exclusiveMinimum: 0
            budgetType:
              type: string
              enum:
                - daily
                - lifetime
            currencyCode:
              type: string
    ActionResponse:
      type: object
      required:
        - ok
      properties:
        ok:
          type: boolean
          const: true
        result:
          type: object
          additionalProperties: true
        asset:
          $ref: '#/components/schemas/NormalizedAsset'
        results:
          type: array
          items:
            type: object
            additionalProperties: true
      additionalProperties: true
    NormalizedAsset:
      type: object
      required:
        - key
        - platform
        - adAccountId
        - assetType
        - assetId
        - name
        - supportedWrites
      properties:
        key:
          type: string
        platform:
          type: string
        adAccountId:
          type: string
        assetType:
          type: string
          enum:
            - campaign
            - adset
            - ad
        assetId:
          type: string
        parentAssetId:
          type: string
        name:
          type: string
        status:
          type: string
        effectiveStatus:
          type: string
        dailyBudget:
          type: number
        lifetimeBudget:
          type: number
        updatedAt:
          type: string
          format: date-time
        supportedWrites:
          type: array
          items:
            type: string
            enum:
              - name
              - status
              - budget
    Error:
      type: object
      required:
        - error
      properties:
        error:
          type: string
          example: Store not found
        requestId:
          type: string
          description: Present on some server errors.
        details:
          description: Optional safe details for an action failure.
        retryAfter:
          type:
            - string
            - 'null'
      additionalProperties: true
  responses:
    BadRequest:
      description: The request path, query, or body is invalid.
      headers:
        x-request-id:
          description: The request identifier selected or generated by Bily.
          schema:
            type: string
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
    Unauthorized:
      description: Authentication is missing or invalid.
      headers:
        x-request-id:
          description: The request identifier selected or generated by Bily.
          schema:
            type: string
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
    Forbidden:
      description: The identity or API key is not allowed to perform this request.
      headers:
        x-request-id:
          description: The request identifier selected or generated by Bily.
          schema:
            type: string
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
    NotFound:
      description: The resource was not found in the caller's accessible scope.
      headers:
        x-request-id:
          description: The request identifier selected or generated by Bily.
          schema:
            type: string
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
    ServerError:
      description: Bily could not complete the request.
      headers:
        x-request-id:
          description: The request identifier selected or generated by Bily.
          schema:
            type: string
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: x-api-key
      description: >-
        A server-side Bily API key created under Settings > MCP > Access key
        fallback. Select the intended store before creating it.
    BearerAuth:
      type: http
      scheme: bearer
      bearerFormat: Bily API key
      description: An alternative way to send the same server-side Bily API key.

````