openapi: 3.1.0
info:
  title: Oracle Eloqua REST Accounts Bulk API
  description: "Oracle Eloqua REST APIs for the Oracle Marketing B2B marketing\nautomation platform. Two API surfaces are covered:\n\n- The **Application API** at `/api/rest/2.0/` for managing assets and\n  data (contacts, accounts, campaigns, emails, forms, custom objects).\n- The **Bulk API** at `/api/bulk/2.0/` for high-volume imports,\n  exports, and sync operations.\n\nBoth surfaces share the same authentication. The base URL is\npod-specific and resolved at runtime per customer from the\n`https://login.eloqua.com/id` discovery endpoint. Authentication is\nOAuth 2.0 Bearer tokens (Authorization Code, Implicit, or Resource\nOwner Password grants) or HTTP Basic Authentication using\n`client_id:client_secret`.\n"
  version: 2.0.0
  contact:
    name: Oracle Eloqua
    url: https://www.oracle.com/cx/marketing/automation/
servers:
- url: https://{pod}.eloqua.com
  description: Customer's Eloqua pod (e.g. secure.p01.eloqua.com).
  variables:
    pod:
      default: secure.p01
      description: The pod-specific subdomain returned by the /id discovery call.
security:
- bearerAuth: []
- basicAuth: []
tags:
- name: Bulk
  description: Bulk import/export and sync operations.
paths:
  /api/bulk/2.0/contacts/exports:
    post:
      tags:
      - Bulk
      summary: Create a bulk contacts export definition
      operationId: createContactExport
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              additionalProperties: true
      responses:
        '201':
          description: Export definition created.
          content:
            application/json:
              schema:
                type: object
                additionalProperties: true
  /api/bulk/2.0/contacts/imports:
    post:
      tags:
      - Bulk
      summary: Create a bulk contacts import definition
      operationId: createContactImport
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              additionalProperties: true
      responses:
        '201':
          description: Import definition created.
          content:
            application/json:
              schema:
                type: object
                additionalProperties: true
  /api/bulk/2.0/syncs:
    post:
      tags:
      - Bulk
      summary: Create a bulk sync
      operationId: createBulkSync
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              additionalProperties: true
      responses:
        '201':
          description: Sync created.
          content:
            application/json:
              schema:
                type: object
                additionalProperties: true
  /api/bulk/2.0/syncs/{id}:
    parameters:
    - $ref: '#/components/parameters/IdParam'
    get:
      tags:
      - Bulk
      summary: Retrieve sync status
      operationId: getBulkSync
      responses:
        '200':
          description: Sync status.
          content:
            application/json:
              schema:
                type: object
                additionalProperties: true
components:
  parameters:
    IdParam:
      name: id
      in: path
      required: true
      schema:
        type: string
      description: Resource ID.
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT
      description: 'OAuth 2.0 access token obtained from

        `https://login.eloqua.com/auth/oauth2/token`. Sent as

        `Authorization: Bearer {access_token}`.

        '
    basicAuth:
      type: http
      scheme: basic
      description: 'HTTP Basic Authentication with `client_id:client_secret`. Used at

        the token endpoint and as a legacy fallback.

        '
externalDocs:
  description: Oracle Eloqua REST API Documentation
  url: https://docs.oracle.com/en/cloud/saas/marketing/eloqua-rest-api/index.html