naftiko: 1.0.0-alpha2 info: label: Unified.to API — ads description: 'Unified.to API — ads. 41 operations. Lead operation: List all ads. Self-contained Naftiko capability covering one Unified To business surface.' tags: - Unified To - ads created: '2026-05-19' modified: '2026-05-19' binds: - namespace: env keys: UNIFIED_TO_API_KEY: UNIFIED_TO_API_KEY capability: consumes: - type: http namespace: marketing-ads baseUri: https://api.unified.to description: Unified.to API — ads business capability. Self-contained, no shared references. resources: - name: ads-connection_id-ad path: /ads/{connection_id}/ad operations: - name: listadsads method: GET description: List all ads outputRawFormat: json outputParameters: - name: result type: object value: $. inputParameters: - name: limit in: query type: number - name: offset in: query type: number - name: updated_gte in: query type: string description: Return only results whose updated date is equal or greater to this value (ISO-8601 / YYYY-MM-DDTHH:MM:SSZ format) - name: sort in: query type: string - name: order in: query type: string - name: query in: query type: string description: Query string to search. eg. email address or name - name: org_id in: query type: string description: The org ID to filter by (reference to AdsOrganization) - name: campaign_id in: query type: string description: The campaign ID to filter by - name: group_id in: query type: string description: The group ID to filter by (reference to AdsGroup) - name: fields in: query type: array description: Fields to return - name: raw in: query type: string description: 'Raw parameters to include in the 3rd-party request. Encoded as a URL component. eg. raw parameters: foo=bar&zoo=bar -> raw=foo%3Dbar%26zoo%3Dbar' - name: connection_id in: path type: string description: ID of the connection required: true - name: createadsad method: POST description: Create an ad outputRawFormat: json outputParameters: - name: result type: object value: $. inputParameters: - name: fields in: query type: array description: Fields to return - name: raw in: query type: string description: 'Raw parameters to include in the 3rd-party request. Encoded as a URL component. eg. raw parameters: foo=bar&zoo=bar -> raw=foo%3Dbar%26zoo%3Dbar' - name: connection_id in: path type: string description: ID of the connection required: true - name: body in: body type: object description: Request body (JSON). required: true - name: ads-connection_id-ad-id path: /ads/{connection_id}/ad/{id} operations: - name: removeadsad method: DELETE description: Remove an ad outputRawFormat: json outputParameters: - name: result type: object value: $. inputParameters: - name: connection_id in: path type: string description: ID of the connection required: true - name: id in: path type: string description: ID of the Ad required: true - name: getadsad method: GET description: Retrieve an ad outputRawFormat: json outputParameters: - name: result type: object value: $. inputParameters: - name: fields in: query type: array description: Fields to return - name: raw in: query type: string description: 'Raw parameters to include in the 3rd-party request. Encoded as a URL component. eg. raw parameters: foo=bar&zoo=bar -> raw=foo%3Dbar%26zoo%3Dbar' - name: connection_id in: path type: string description: ID of the connection required: true - name: id in: path type: string description: ID of the Ad required: true - name: patchadsad method: PATCH description: Update an ad outputRawFormat: json outputParameters: - name: result type: object value: $. inputParameters: - name: fields in: query type: array description: Fields to return - name: raw in: query type: string description: 'Raw parameters to include in the 3rd-party request. Encoded as a URL component. eg. raw parameters: foo=bar&zoo=bar -> raw=foo%3Dbar%26zoo%3Dbar' - name: connection_id in: path type: string description: ID of the connection required: true - name: id in: path type: string description: ID of the Ad required: true - name: body in: body type: object description: Request body (JSON). required: true - name: updateadsad method: PUT description: Update an ad outputRawFormat: json outputParameters: - name: result type: object value: $. inputParameters: - name: fields in: query type: array description: Fields to return - name: raw in: query type: string description: 'Raw parameters to include in the 3rd-party request. Encoded as a URL component. eg. raw parameters: foo=bar&zoo=bar -> raw=foo%3Dbar%26zoo%3Dbar' - name: connection_id in: path type: string description: ID of the connection required: true - name: id in: path type: string description: ID of the Ad required: true - name: body in: body type: object description: Request body (JSON). required: true - name: ads-connection_id-campaign path: /ads/{connection_id}/campaign operations: - name: listadscampaigns method: GET description: List all campaigns outputRawFormat: json outputParameters: - name: result type: object value: $. inputParameters: - name: limit in: query type: number - name: offset in: query type: number - name: updated_gte in: query type: string description: Return only results whose updated date is equal or greater to this value (ISO-8601 / YYYY-MM-DDTHH:MM:SSZ format) - name: sort in: query type: string - name: order in: query type: string - name: query in: query type: string description: Query string to search. eg. email address or name - name: org_id in: query type: string description: The org ID to filter by (reference to AdsOrganization) - name: start_gte in: query type: string description: The start date to filter by (ISO-8601 / YYYY-MM-DDTHH:MM:SSZ format) - name: end_lt in: query type: string description: The end date to filter by (ISO-8601 / YYYY-MM-DDTHH:MM:SSZ format) - name: fields in: query type: array description: Fields to return - name: raw in: query type: string description: 'Raw parameters to include in the 3rd-party request. Encoded as a URL component. eg. raw parameters: foo=bar&zoo=bar -> raw=foo%3Dbar%26zoo%3Dbar' - name: connection_id in: path type: string description: ID of the connection required: true - name: createadscampaign method: POST description: Create a campaign outputRawFormat: json outputParameters: - name: result type: object value: $. inputParameters: - name: fields in: query type: array description: Fields to return - name: raw in: query type: string description: 'Raw parameters to include in the 3rd-party request. Encoded as a URL component. eg. raw parameters: foo=bar&zoo=bar -> raw=foo%3Dbar%26zoo%3Dbar' - name: connection_id in: path type: string description: ID of the connection required: true - name: body in: body type: object description: Request body (JSON). required: true - name: ads-connection_id-campaign-id path: /ads/{connection_id}/campaign/{id} operations: - name: removeadscampaign method: DELETE description: Remove a campaign outputRawFormat: json outputParameters: - name: result type: object value: $. inputParameters: - name: connection_id in: path type: string description: ID of the connection required: true - name: id in: path type: string description: ID of the Campaign required: true - name: getadscampaign method: GET description: Retrieve a campaign outputRawFormat: json outputParameters: - name: result type: object value: $. inputParameters: - name: fields in: query type: array description: Fields to return - name: raw in: query type: string description: 'Raw parameters to include in the 3rd-party request. Encoded as a URL component. eg. raw parameters: foo=bar&zoo=bar -> raw=foo%3Dbar%26zoo%3Dbar' - name: connection_id in: path type: string description: ID of the connection required: true - name: id in: path type: string description: ID of the Campaign required: true - name: patchadscampaign method: PATCH description: Update a campaign outputRawFormat: json outputParameters: - name: result type: object value: $. inputParameters: - name: fields in: query type: array description: Fields to return - name: raw in: query type: string description: 'Raw parameters to include in the 3rd-party request. Encoded as a URL component. eg. raw parameters: foo=bar&zoo=bar -> raw=foo%3Dbar%26zoo%3Dbar' - name: connection_id in: path type: string description: ID of the connection required: true - name: id in: path type: string description: ID of the Campaign required: true - name: body in: body type: object description: Request body (JSON). required: true - name: updateadscampaign method: PUT description: Update a campaign outputRawFormat: json outputParameters: - name: result type: object value: $. inputParameters: - name: fields in: query type: array description: Fields to return - name: raw in: query type: string description: 'Raw parameters to include in the 3rd-party request. Encoded as a URL component. eg. raw parameters: foo=bar&zoo=bar -> raw=foo%3Dbar%26zoo%3Dbar' - name: connection_id in: path type: string description: ID of the connection required: true - name: id in: path type: string description: ID of the Campaign required: true - name: body in: body type: object description: Request body (JSON). required: true - name: ads-connection_id-creative path: /ads/{connection_id}/creative operations: - name: listadscreatives method: GET description: List all creatives outputRawFormat: json outputParameters: - name: result type: object value: $. inputParameters: - name: limit in: query type: number - name: offset in: query type: number - name: updated_gte in: query type: string description: Return only results whose updated date is equal or greater to this value (ISO-8601 / YYYY-MM-DDTHH:MM:SSZ format) - name: sort in: query type: string - name: order in: query type: string - name: query in: query type: string description: Query string to search. eg. email address or name - name: org_id in: query type: string description: The org ID to filter by (reference to AdsOrganization) - name: group_id in: query type: string description: The group ID to filter by (reference to AdsGroup) - name: fields in: query type: array description: Fields to return - name: raw in: query type: string description: 'Raw parameters to include in the 3rd-party request. Encoded as a URL component. eg. raw parameters: foo=bar&zoo=bar -> raw=foo%3Dbar%26zoo%3Dbar' - name: connection_id in: path type: string description: ID of the connection required: true - name: createadscreative method: POST description: Create a creative outputRawFormat: json outputParameters: - name: result type: object value: $. inputParameters: - name: fields in: query type: array description: Fields to return - name: raw in: query type: string description: 'Raw parameters to include in the 3rd-party request. Encoded as a URL component. eg. raw parameters: foo=bar&zoo=bar -> raw=foo%3Dbar%26zoo%3Dbar' - name: connection_id in: path type: string description: ID of the connection required: true - name: body in: body type: object description: Request body (JSON). required: true - name: ads-connection_id-creative-id path: /ads/{connection_id}/creative/{id} operations: - name: removeadscreative method: DELETE description: Remove a creative outputRawFormat: json outputParameters: - name: result type: object value: $. inputParameters: - name: connection_id in: path type: string description: ID of the connection required: true - name: id in: path type: string description: ID of the Creative required: true - name: getadscreative method: GET description: Retrieve a creative outputRawFormat: json outputParameters: - name: result type: object value: $. inputParameters: - name: fields in: query type: array description: Fields to return - name: raw in: query type: string description: 'Raw parameters to include in the 3rd-party request. Encoded as a URL component. eg. raw parameters: foo=bar&zoo=bar -> raw=foo%3Dbar%26zoo%3Dbar' - name: connection_id in: path type: string description: ID of the connection required: true - name: id in: path type: string description: ID of the Creative required: true - name: patchadscreative method: PATCH description: Update a creative outputRawFormat: json outputParameters: - name: result type: object value: $. inputParameters: - name: fields in: query type: array description: Fields to return - name: raw in: query type: string description: 'Raw parameters to include in the 3rd-party request. Encoded as a URL component. eg. raw parameters: foo=bar&zoo=bar -> raw=foo%3Dbar%26zoo%3Dbar' - name: connection_id in: path type: string description: ID of the connection required: true - name: id in: path type: string description: ID of the Creative required: true - name: body in: body type: object description: Request body (JSON). required: true - name: updateadscreative method: PUT description: Update a creative outputRawFormat: json outputParameters: - name: result type: object value: $. inputParameters: - name: fields in: query type: array description: Fields to return - name: raw in: query type: string description: 'Raw parameters to include in the 3rd-party request. Encoded as a URL component. eg. raw parameters: foo=bar&zoo=bar -> raw=foo%3Dbar%26zoo%3Dbar' - name: connection_id in: path type: string description: ID of the connection required: true - name: id in: path type: string description: ID of the Creative required: true - name: body in: body type: object description: Request body (JSON). required: true - name: ads-connection_id-group path: /ads/{connection_id}/group operations: - name: listadsgroups method: GET description: List all groups outputRawFormat: json outputParameters: - name: result type: object value: $. inputParameters: - name: limit in: query type: number - name: offset in: query type: number - name: updated_gte in: query type: string description: Return only results whose updated date is equal or greater to this value (ISO-8601 / YYYY-MM-DDTHH:MM:SSZ format) - name: sort in: query type: string - name: order in: query type: string - name: query in: query type: string description: Query string to search. eg. email address or name - name: org_id in: query type: string description: The org ID to filter by (reference to AdsOrganization) - name: campaign_id in: query type: string description: The campaign ID to filter by - name: parent_id in: query type: string description: The parent ID to filter by - name: io_id in: query type: string description: The IO ID to filter by - name: start_gte in: query type: string description: The start date to filter by (ISO-8601 / YYYY-MM-DDTHH:MM:SSZ format) - name: end_lt in: query type: string description: The end date to filter by (ISO-8601 / YYYY-MM-DDTHH:MM:SSZ format) - name: fields in: query type: array description: Fields to return - name: raw in: query type: string description: 'Raw parameters to include in the 3rd-party request. Encoded as a URL component. eg. raw parameters: foo=bar&zoo=bar -> raw=foo%3Dbar%26zoo%3Dbar' - name: connection_id in: path type: string description: ID of the connection required: true - name: createadsgroup method: POST description: Create a group outputRawFormat: json outputParameters: - name: result type: object value: $. inputParameters: - name: fields in: query type: array description: Fields to return - name: raw in: query type: string description: 'Raw parameters to include in the 3rd-party request. Encoded as a URL component. eg. raw parameters: foo=bar&zoo=bar -> raw=foo%3Dbar%26zoo%3Dbar' - name: connection_id in: path type: string description: ID of the connection required: true - name: body in: body type: object description: Request body (JSON). required: true - name: ads-connection_id-group-id path: /ads/{connection_id}/group/{id} operations: - name: removeadsgroup method: DELETE description: Remove a group outputRawFormat: json outputParameters: - name: result type: object value: $. inputParameters: - name: connection_id in: path type: string description: ID of the connection required: true - name: id in: path type: string description: ID of the Group required: true - name: getadsgroup method: GET description: Retrieve a group outputRawFormat: json outputParameters: - name: result type: object value: $. inputParameters: - name: fields in: query type: array description: Fields to return - name: raw in: query type: string description: 'Raw parameters to include in the 3rd-party request. Encoded as a URL component. eg. raw parameters: foo=bar&zoo=bar -> raw=foo%3Dbar%26zoo%3Dbar' - name: connection_id in: path type: string description: ID of the connection required: true - name: id in: path type: string description: ID of the Group required: true - name: patchadsgroup method: PATCH description: Update a group outputRawFormat: json outputParameters: - name: result type: object value: $. inputParameters: - name: fields in: query type: array description: Fields to return - name: raw in: query type: string description: 'Raw parameters to include in the 3rd-party request. Encoded as a URL component. eg. raw parameters: foo=bar&zoo=bar -> raw=foo%3Dbar%26zoo%3Dbar' - name: connection_id in: path type: string description: ID of the connection required: true - name: id in: path type: string description: ID of the Group required: true - name: body in: body type: object description: Request body (JSON). required: true - name: updateadsgroup method: PUT description: Update a group outputRawFormat: json outputParameters: - name: result type: object value: $. inputParameters: - name: fields in: query type: array description: Fields to return - name: raw in: query type: string description: 'Raw parameters to include in the 3rd-party request. Encoded as a URL component. eg. raw parameters: foo=bar&zoo=bar -> raw=foo%3Dbar%26zoo%3Dbar' - name: connection_id in: path type: string description: ID of the connection required: true - name: id in: path type: string description: ID of the Group required: true - name: body in: body type: object description: Request body (JSON). required: true - name: ads-connection_id-insertionorder path: /ads/{connection_id}/insertionorder operations: - name: listadsinsertionorders method: GET description: List all insertionorders outputRawFormat: json outputParameters: - name: result type: object value: $. inputParameters: - name: limit in: query type: number - name: offset in: query type: number - name: updated_gte in: query type: string description: Return only results whose updated date is equal or greater to this value (ISO-8601 / YYYY-MM-DDTHH:MM:SSZ format) - name: sort in: query type: string - name: order in: query type: string - name: query in: query type: string description: Query string to search. eg. email address or name - name: org_id in: query type: string description: The org ID to filter by (reference to AdsOrganization) - name: campaign_id in: query type: string description: The campaign ID to filter by - name: fields in: query type: array description: Fields to return - name: raw in: query type: string description: 'Raw parameters to include in the 3rd-party request. Encoded as a URL component. eg. raw parameters: foo=bar&zoo=bar -> raw=foo%3Dbar%26zoo%3Dbar' - name: connection_id in: path type: string description: ID of the connection required: true - name: createadsinsertionorder method: POST description: Create an insertionorder outputRawFormat: json outputParameters: - name: result type: object value: $. inputParameters: - name: fields in: query type: array description: Fields to return - name: raw in: query type: string description: 'Raw parameters to include in the 3rd-party request. Encoded as a URL component. eg. raw parameters: foo=bar&zoo=bar -> raw=foo%3Dbar%26zoo%3Dbar' - name: connection_id in: path type: string description: ID of the connection required: true - name: body in: body type: object description: Request body (JSON). required: true - name: ads-connection_id-insertionorder-id path: /ads/{connection_id}/insertionorder/{id} operations: - name: removeadsinsertionorder method: DELETE description: Remove an insertionorder outputRawFormat: json outputParameters: - name: result type: object value: $. inputParameters: - name: connection_id in: path type: string description: ID of the connection required: true - name: id in: path type: string description: ID of the Insertionorder required: true - name: getadsinsertionorder method: GET description: Retrieve an insertionorder outputRawFormat: json outputParameters: - name: result type: object value: $. inputParameters: - name: fields in: query type: array description: Fields to return - name: raw in: query type: string description: 'Raw parameters to include in the 3rd-party request. Encoded as a URL component. eg. raw parameters: foo=bar&zoo=bar -> raw=foo%3Dbar%26zoo%3Dbar' - name: connection_id in: path type: string description: ID of the connection required: true - name: id in: path type: string description: ID of the Insertionorder required: true - name: patchadsinsertionorder method: PATCH description: Update an insertionorder outputRawFormat: json outputParameters: - name: result type: object value: $. inputParameters: - name: fields in: query type: array description: Fields to return - name: raw in: query type: string description: 'Raw parameters to include in the 3rd-party request. Encoded as a URL component. eg. raw parameters: foo=bar&zoo=bar -> raw=foo%3Dbar%26zoo%3Dbar' - name: connection_id in: path type: string description: ID of the connection required: true - name: id in: path type: string description: ID of the Insertionorder required: true - name: body in: body type: object description: Request body (JSON). required: true - name: updateadsinsertionorder method: PUT description: Update an insertionorder outputRawFormat: json outputParameters: - name: result type: object value: $. inputParameters: - name: fields in: query type: array description: Fields to return - name: raw in: query type: string description: 'Raw parameters to include in the 3rd-party request. Encoded as a URL component. eg. raw parameters: foo=bar&zoo=bar -> raw=foo%3Dbar%26zoo%3Dbar' - name: connection_id in: path type: string description: ID of the connection required: true - name: id in: path type: string description: ID of the Insertionorder required: true - name: body in: body type: object description: Request body (JSON). required: true - name: ads-connection_id-organization path: /ads/{connection_id}/organization operations: - name: listadsorganizations method: GET description: List all organizations outputRawFormat: json outputParameters: - name: result type: object value: $. inputParameters: - name: limit in: query type: number - name: offset in: query type: number - name: updated_gte in: query type: string description: Return only results whose updated date is equal or greater to this value (ISO-8601 / YYYY-MM-DDTHH:MM:SSZ format) - name: sort in: query type: string - name: order in: query type: string - name: query in: query type: string description: Query string to search. eg. email address or name - name: parent_id in: query type: string description: The parent ID to filter by - name: fields in: query type: array description: Fields to return - name: raw in: query type: string description: 'Raw parameters to include in the 3rd-party request. Encoded as a URL component. eg. raw parameters: foo=bar&zoo=bar -> raw=foo%3Dbar%26zoo%3Dbar' - name: connection_id in: path type: string description: ID of the connection required: true - name: createadsorganization method: POST description: Create an organization outputRawFormat: json outputParameters: - name: result type: object value: $. inputParameters: - name: fields in: query type: array description: Fields to return - name: raw in: query type: string description: 'Raw parameters to include in the 3rd-party request. Encoded as a URL component. eg. raw parameters: foo=bar&zoo=bar -> raw=foo%3Dbar%26zoo%3Dbar' - name: connection_id in: path type: string description: ID of the connection required: true - name: body in: body type: object description: Request body (JSON). required: true - name: ads-connection_id-organization-id path: /ads/{connection_id}/organization/{id} operations: - name: removeadsorganization method: DELETE description: Remove an organization outputRawFormat: json outputParameters: - name: result type: object value: $. inputParameters: - name: connection_id in: path type: string description: ID of the connection required: true - name: id in: path type: string description: ID of the Organization required: true - name: getadsorganization method: GET description: Retrieve an organization outputRawFormat: json outputParameters: - name: result type: object value: $. inputParameters: - name: fields in: query type: array description: Fields to return - name: raw in: query type: string description: 'Raw parameters to include in the 3rd-party request. Encoded as a URL component. eg. raw parameters: foo=bar&zoo=bar -> raw=foo%3Dbar%26zoo%3Dbar' - name: connection_id in: path type: string description: ID of the connection required: true - name: id in: path type: string description: ID of the Organization required: true - name: patchadsorganization method: PATCH description: Update an organization outputRawFormat: json outputParameters: - name: result type: object value: $. inputParameters: - name: fields in: query type: array description: Fields to return - name: raw in: query type: string description: 'Raw parameters to include in the 3rd-party request. Encoded as a URL component. eg. raw parameters: foo=bar&zoo=bar -> raw=foo%3Dbar%26zoo%3Dbar' - name: connection_id in: path type: string description: ID of the connection required: true - name: id in: path type: string description: ID of the Organization required: true - name: body in: body type: object description: Request body (JSON). required: true - name: updateadsorganization method: PUT description: Update an organization outputRawFormat: json outputParameters: - name: result type: object value: $. inputParameters: - name: fields in: query type: array description: Fields to return - name: raw in: query type: string description: 'Raw parameters to include in the 3rd-party request. Encoded as a URL component. eg. raw parameters: foo=bar&zoo=bar -> raw=foo%3Dbar%26zoo%3Dbar' - name: connection_id in: path type: string description: ID of the connection required: true - name: id in: path type: string description: ID of the Organization required: true - name: body in: body type: object description: Request body (JSON). required: true - name: ads-connection_id-promoted path: /ads/{connection_id}/promoted operations: - name: listadspromoteds method: GET description: List all promoteds outputRawFormat: json outputParameters: - name: result type: object value: $. inputParameters: - name: limit in: query type: number - name: offset in: query type: number - name: updated_gte in: query type: string description: Return only results whose updated date is equal or greater to this value (ISO-8601 / YYYY-MM-DDTHH:MM:SSZ format) - name: sort in: query type: string - name: order in: query type: string - name: query in: query type: string description: Query string to search. eg. email address or name - name: org_id in: query type: string description: The org ID to filter by (reference to AdsOrganization) - name: type in: query type: string - name: fields in: query type: array description: Fields to return - name: raw in: query type: string description: 'Raw parameters to include in the 3rd-party request. Encoded as a URL component. eg. raw parameters: foo=bar&zoo=bar -> raw=foo%3Dbar%26zoo%3Dbar' - name: connection_id in: path type: string description: ID of the connection required: true - name: ads-connection_id-promoted-id path: /ads/{connection_id}/promoted/{id} operations: - name: getadspromoted method: GET description: Retrieve a promoted outputRawFormat: json outputParameters: - name: result type: object value: $. inputParameters: - name: fields in: query type: array description: Fields to return - name: raw in: query type: string description: 'Raw parameters to include in the 3rd-party request. Encoded as a URL component. eg. raw parameters: foo=bar&zoo=bar -> raw=foo%3Dbar%26zoo%3Dbar' - name: connection_id in: path type: string description: ID of the connection required: true - name: id in: path type: string description: ID of the Promoted required: true - name: ads-connection_id-report path: /ads/{connection_id}/report operations: - name: listadsreports method: GET description: List all reports outputRawFormat: json outputParameters: - name: result type: object value: $. inputParameters: - name: limit in: query type: number - name: offset in: query type: number - name: updated_gte in: query type: string description: Return only results whose updated date is equal or greater to this value (ISO-8601 / YYYY-MM-DDTHH:MM:SSZ format) - name: sort in: query type: string - name: order in: query type: string - name: query in: query type: string description: Query string to search. eg. email address or name - name: org_id in: query type: string description: The org ID to filter by (reference to AdsOrganization) - name: campaign_id in: query type: string description: The campaign ID to filter by - name: group_id in: query type: string description: The group ID to filter by (reference to AdsGroup) - name: ad_id in: query type: string description: The ad ID to filter by - name: type in: query type: string - name: start_gte in: query type: string description: The start date to filter by (ISO-8601 / YYYY-MM-DDTHH:MM:SSZ format) - name: end_lt in: query type: string description: The end date to filter by (ISO-8601 / YYYY-MM-DDTHH:MM:SSZ format) - name: fields in: query type: array description: Fields to return - name: raw in: query type: string description: 'Raw parameters to include in the 3rd-party request. Encoded as a URL component. eg. raw parameters: foo=bar&zoo=bar -> raw=foo%3Dbar%26zoo%3Dbar' - name: connection_id in: path type: string description: ID of the connection required: true - name: ads-connection_id-target path: /ads/{connection_id}/target operations: - name: listadstargets method: GET description: List all targets outputRawFormat: json outputParameters: - name: result type: object value: $. inputParameters: - name: limit in: query type: number - name: offset in: query type: number - name: updated_gte in: query type: string description: Return only results whose updated date is equal or greater to this value (ISO-8601 / YYYY-MM-DDTHH:MM:SSZ format) - name: sort in: query type: string - name: order in: query type: string - name: query in: query type: string description: Query string to search. eg. email address or name - name: org_id in: query type: string description: The org ID to filter by (reference to AdsOrganization) - name: type in: query type: string - name: fields in: query type: array description: Fields to return - name: raw in: query type: string description: 'Raw parameters to include in the 3rd-party request. Encoded as a URL component. eg. raw parameters: foo=bar&zoo=bar -> raw=foo%3Dbar%26zoo%3Dbar' - name: connection_id in: path type: string description: ID of the connection required: true - name: ads-connection_id-target-id path: /ads/{connection_id}/target/{id} operations: - name: getadstarget method: GET description: Retrieve a target outputRawFormat: json outputParameters: - name: result type: object value: $. inputParameters: - name: fields in: query type: array description: Fields to return - name: raw in: query type: string description: 'Raw parameters to include in the 3rd-party request. Encoded as a URL component. eg. raw parameters: foo=bar&zoo=bar -> raw=foo%3Dbar%26zoo%3Dbar' - name: connection_id in: path type: string description: ID of the connection required: true - name: id in: path type: string description: ID of the Target required: true authentication: type: apikey key: authorization value: '{{env.UNIFIED_TO_API_KEY}}' placement: header exposes: - type: rest namespace: marketing-ads-rest port: 8080 description: REST adapter for Unified.to API — ads. One Spectral-compliant resource per consumed operation, prefixed with /v1. resources: - path: /v1/ads/{connection-id}/ad name: ads-connection-id-ad description: REST surface for ads-connection_id-ad. operations: - method: GET name: listadsads description: List all ads call: marketing-ads.listadsads with: limit: rest.limit offset: rest.offset updated_gte: rest.updated_gte sort: rest.sort order: rest.order query: rest.query org_id: rest.org_id campaign_id: rest.campaign_id group_id: rest.group_id fields: rest.fields raw: rest.raw connection_id: rest.connection_id outputParameters: - type: object mapping: $. - method: POST name: createadsad description: Create an ad call: marketing-ads.createadsad with: fields: rest.fields raw: rest.raw connection_id: rest.connection_id body: rest.body outputParameters: - type: object mapping: $. - path: /v1/ads/{connection-id}/ad/{id} name: ads-connection-id-ad-id description: REST surface for ads-connection_id-ad-id. operations: - method: DELETE name: removeadsad description: Remove an ad call: marketing-ads.removeadsad with: connection_id: rest.connection_id id: rest.id outputParameters: - type: object mapping: $. - method: GET name: getadsad description: Retrieve an ad call: marketing-ads.getadsad with: fields: rest.fields raw: rest.raw connection_id: rest.connection_id id: rest.id outputParameters: - type: object mapping: $. - method: PATCH name: patchadsad description: Update an ad call: marketing-ads.patchadsad with: fields: rest.fields raw: rest.raw connection_id: rest.connection_id id: rest.id body: rest.body outputParameters: - type: object mapping: $. - method: PUT name: updateadsad description: Update an ad call: marketing-ads.updateadsad with: fields: rest.fields raw: rest.raw connection_id: rest.connection_id id: rest.id body: rest.body outputParameters: - type: object mapping: $. - path: /v1/ads/{connection-id}/campaign name: ads-connection-id-campaign description: REST surface for ads-connection_id-campaign. operations: - method: GET name: listadscampaigns description: List all campaigns call: marketing-ads.listadscampaigns with: limit: rest.limit offset: rest.offset updated_gte: rest.updated_gte sort: rest.sort order: rest.order query: rest.query org_id: rest.org_id start_gte: rest.start_gte end_lt: rest.end_lt fields: rest.fields raw: rest.raw connection_id: rest.connection_id outputParameters: - type: object mapping: $. - method: POST name: createadscampaign description: Create a campaign call: marketing-ads.createadscampaign with: fields: rest.fields raw: rest.raw connection_id: rest.connection_id body: rest.body outputParameters: - type: object mapping: $. - path: /v1/ads/{connection-id}/campaign/{id} name: ads-connection-id-campaign-id description: REST surface for ads-connection_id-campaign-id. operations: - method: DELETE name: removeadscampaign description: Remove a campaign call: marketing-ads.removeadscampaign with: connection_id: rest.connection_id id: rest.id outputParameters: - type: object mapping: $. - method: GET name: getadscampaign description: Retrieve a campaign call: marketing-ads.getadscampaign with: fields: rest.fields raw: rest.raw connection_id: rest.connection_id id: rest.id outputParameters: - type: object mapping: $. - method: PATCH name: patchadscampaign description: Update a campaign call: marketing-ads.patchadscampaign with: fields: rest.fields raw: rest.raw connection_id: rest.connection_id id: rest.id body: rest.body outputParameters: - type: object mapping: $. - method: PUT name: updateadscampaign description: Update a campaign call: marketing-ads.updateadscampaign with: fields: rest.fields raw: rest.raw connection_id: rest.connection_id id: rest.id body: rest.body outputParameters: - type: object mapping: $. - path: /v1/ads/{connection-id}/creative name: ads-connection-id-creative description: REST surface for ads-connection_id-creative. operations: - method: GET name: listadscreatives description: List all creatives call: marketing-ads.listadscreatives with: limit: rest.limit offset: rest.offset updated_gte: rest.updated_gte sort: rest.sort order: rest.order query: rest.query org_id: rest.org_id group_id: rest.group_id fields: rest.fields raw: rest.raw connection_id: rest.connection_id outputParameters: - type: object mapping: $. - method: POST name: createadscreative description: Create a creative call: marketing-ads.createadscreative with: fields: rest.fields raw: rest.raw connection_id: rest.connection_id body: rest.body outputParameters: - type: object mapping: $. - path: /v1/ads/{connection-id}/creative/{id} name: ads-connection-id-creative-id description: REST surface for ads-connection_id-creative-id. operations: - method: DELETE name: removeadscreative description: Remove a creative call: marketing-ads.removeadscreative with: connection_id: rest.connection_id id: rest.id outputParameters: - type: object mapping: $. - method: GET name: getadscreative description: Retrieve a creative call: marketing-ads.getadscreative with: fields: rest.fields raw: rest.raw connection_id: rest.connection_id id: rest.id outputParameters: - type: object mapping: $. - method: PATCH name: patchadscreative description: Update a creative call: marketing-ads.patchadscreative with: fields: rest.fields raw: rest.raw connection_id: rest.connection_id id: rest.id body: rest.body outputParameters: - type: object mapping: $. - method: PUT name: updateadscreative description: Update a creative call: marketing-ads.updateadscreative with: fields: rest.fields raw: rest.raw connection_id: rest.connection_id id: rest.id body: rest.body outputParameters: - type: object mapping: $. - path: /v1/ads/{connection-id}/group name: ads-connection-id-group description: REST surface for ads-connection_id-group. operations: - method: GET name: listadsgroups description: List all groups call: marketing-ads.listadsgroups with: limit: rest.limit offset: rest.offset updated_gte: rest.updated_gte sort: rest.sort order: rest.order query: rest.query org_id: rest.org_id campaign_id: rest.campaign_id parent_id: rest.parent_id io_id: rest.io_id start_gte: rest.start_gte end_lt: rest.end_lt fields: rest.fields raw: rest.raw connection_id: rest.connection_id outputParameters: - type: object mapping: $. - method: POST name: createadsgroup description: Create a group call: marketing-ads.createadsgroup with: fields: rest.fields raw: rest.raw connection_id: rest.connection_id body: rest.body outputParameters: - type: object mapping: $. - path: /v1/ads/{connection-id}/group/{id} name: ads-connection-id-group-id description: REST surface for ads-connection_id-group-id. operations: - method: DELETE name: removeadsgroup description: Remove a group call: marketing-ads.removeadsgroup with: connection_id: rest.connection_id id: rest.id outputParameters: - type: object mapping: $. - method: GET name: getadsgroup description: Retrieve a group call: marketing-ads.getadsgroup with: fields: rest.fields raw: rest.raw connection_id: rest.connection_id id: rest.id outputParameters: - type: object mapping: $. - method: PATCH name: patchadsgroup description: Update a group call: marketing-ads.patchadsgroup with: fields: rest.fields raw: rest.raw connection_id: rest.connection_id id: rest.id body: rest.body outputParameters: - type: object mapping: $. - method: PUT name: updateadsgroup description: Update a group call: marketing-ads.updateadsgroup with: fields: rest.fields raw: rest.raw connection_id: rest.connection_id id: rest.id body: rest.body outputParameters: - type: object mapping: $. - path: /v1/ads/{connection-id}/insertionorder name: ads-connection-id-insertionorder description: REST surface for ads-connection_id-insertionorder. operations: - method: GET name: listadsinsertionorders description: List all insertionorders call: marketing-ads.listadsinsertionorders with: limit: rest.limit offset: rest.offset updated_gte: rest.updated_gte sort: rest.sort order: rest.order query: rest.query org_id: rest.org_id campaign_id: rest.campaign_id fields: rest.fields raw: rest.raw connection_id: rest.connection_id outputParameters: - type: object mapping: $. - method: POST name: createadsinsertionorder description: Create an insertionorder call: marketing-ads.createadsinsertionorder with: fields: rest.fields raw: rest.raw connection_id: rest.connection_id body: rest.body outputParameters: - type: object mapping: $. - path: /v1/ads/{connection-id}/insertionorder/{id} name: ads-connection-id-insertionorder-id description: REST surface for ads-connection_id-insertionorder-id. operations: - method: DELETE name: removeadsinsertionorder description: Remove an insertionorder call: marketing-ads.removeadsinsertionorder with: connection_id: rest.connection_id id: rest.id outputParameters: - type: object mapping: $. - method: GET name: getadsinsertionorder description: Retrieve an insertionorder call: marketing-ads.getadsinsertionorder with: fields: rest.fields raw: rest.raw connection_id: rest.connection_id id: rest.id outputParameters: - type: object mapping: $. - method: PATCH name: patchadsinsertionorder description: Update an insertionorder call: marketing-ads.patchadsinsertionorder with: fields: rest.fields raw: rest.raw connection_id: rest.connection_id id: rest.id body: rest.body outputParameters: - type: object mapping: $. - method: PUT name: updateadsinsertionorder description: Update an insertionorder call: marketing-ads.updateadsinsertionorder with: fields: rest.fields raw: rest.raw connection_id: rest.connection_id id: rest.id body: rest.body outputParameters: - type: object mapping: $. - path: /v1/ads/{connection-id}/organization name: ads-connection-id-organization description: REST surface for ads-connection_id-organization. operations: - method: GET name: listadsorganizations description: List all organizations call: marketing-ads.listadsorganizations with: limit: rest.limit offset: rest.offset updated_gte: rest.updated_gte sort: rest.sort order: rest.order query: rest.query parent_id: rest.parent_id fields: rest.fields raw: rest.raw connection_id: rest.connection_id outputParameters: - type: object mapping: $. - method: POST name: createadsorganization description: Create an organization call: marketing-ads.createadsorganization with: fields: rest.fields raw: rest.raw connection_id: rest.connection_id body: rest.body outputParameters: - type: object mapping: $. - path: /v1/ads/{connection-id}/organization/{id} name: ads-connection-id-organization-id description: REST surface for ads-connection_id-organization-id. operations: - method: DELETE name: removeadsorganization description: Remove an organization call: marketing-ads.removeadsorganization with: connection_id: rest.connection_id id: rest.id outputParameters: - type: object mapping: $. - method: GET name: getadsorganization description: Retrieve an organization call: marketing-ads.getadsorganization with: fields: rest.fields raw: rest.raw connection_id: rest.connection_id id: rest.id outputParameters: - type: object mapping: $. - method: PATCH name: patchadsorganization description: Update an organization call: marketing-ads.patchadsorganization with: fields: rest.fields raw: rest.raw connection_id: rest.connection_id id: rest.id body: rest.body outputParameters: - type: object mapping: $. - method: PUT name: updateadsorganization description: Update an organization call: marketing-ads.updateadsorganization with: fields: rest.fields raw: rest.raw connection_id: rest.connection_id id: rest.id body: rest.body outputParameters: - type: object mapping: $. - path: /v1/ads/{connection-id}/promoted name: ads-connection-id-promoted description: REST surface for ads-connection_id-promoted. operations: - method: GET name: listadspromoteds description: List all promoteds call: marketing-ads.listadspromoteds with: limit: rest.limit offset: rest.offset updated_gte: rest.updated_gte sort: rest.sort order: rest.order query: rest.query org_id: rest.org_id type: rest.type fields: rest.fields raw: rest.raw connection_id: rest.connection_id outputParameters: - type: object mapping: $. - path: /v1/ads/{connection-id}/promoted/{id} name: ads-connection-id-promoted-id description: REST surface for ads-connection_id-promoted-id. operations: - method: GET name: getadspromoted description: Retrieve a promoted call: marketing-ads.getadspromoted with: fields: rest.fields raw: rest.raw connection_id: rest.connection_id id: rest.id outputParameters: - type: object mapping: $. - path: /v1/ads/{connection-id}/report name: ads-connection-id-report description: REST surface for ads-connection_id-report. operations: - method: GET name: listadsreports description: List all reports call: marketing-ads.listadsreports with: limit: rest.limit offset: rest.offset updated_gte: rest.updated_gte sort: rest.sort order: rest.order query: rest.query org_id: rest.org_id campaign_id: rest.campaign_id group_id: rest.group_id ad_id: rest.ad_id type: rest.type start_gte: rest.start_gte end_lt: rest.end_lt fields: rest.fields raw: rest.raw connection_id: rest.connection_id outputParameters: - type: object mapping: $. - path: /v1/ads/{connection-id}/target name: ads-connection-id-target description: REST surface for ads-connection_id-target. operations: - method: GET name: listadstargets description: List all targets call: marketing-ads.listadstargets with: limit: rest.limit offset: rest.offset updated_gte: rest.updated_gte sort: rest.sort order: rest.order query: rest.query org_id: rest.org_id type: rest.type fields: rest.fields raw: rest.raw connection_id: rest.connection_id outputParameters: - type: object mapping: $. - path: /v1/ads/{connection-id}/target/{id} name: ads-connection-id-target-id description: REST surface for ads-connection_id-target-id. operations: - method: GET name: getadstarget description: Retrieve a target call: marketing-ads.getadstarget with: fields: rest.fields raw: rest.raw connection_id: rest.connection_id id: rest.id outputParameters: - type: object mapping: $. - type: mcp namespace: marketing-ads-mcp port: 9090 transport: http description: MCP adapter for Unified.to API — ads. One tool per consumed operation, routed inline through this capability's consumes block. tools: - name: list-all-ads description: List all ads hints: readOnly: true destructive: false idempotent: true call: marketing-ads.listadsads with: limit: tools.limit offset: tools.offset updated_gte: tools.updated_gte sort: tools.sort order: tools.order query: tools.query org_id: tools.org_id campaign_id: tools.campaign_id group_id: tools.group_id fields: tools.fields raw: tools.raw connection_id: tools.connection_id outputParameters: - type: object mapping: $. - name: create-ad description: Create an ad hints: readOnly: false destructive: false idempotent: false call: marketing-ads.createadsad with: fields: tools.fields raw: tools.raw connection_id: tools.connection_id body: tools.body outputParameters: - type: object mapping: $. - name: remove-ad description: Remove an ad hints: readOnly: false destructive: true idempotent: true call: marketing-ads.removeadsad with: connection_id: tools.connection_id id: tools.id outputParameters: - type: object mapping: $. - name: retrieve-ad description: Retrieve an ad hints: readOnly: true destructive: false idempotent: true call: marketing-ads.getadsad with: fields: tools.fields raw: tools.raw connection_id: tools.connection_id id: tools.id outputParameters: - type: object mapping: $. - name: update-ad description: Update an ad hints: readOnly: false destructive: false idempotent: true call: marketing-ads.patchadsad with: fields: tools.fields raw: tools.raw connection_id: tools.connection_id id: tools.id body: tools.body outputParameters: - type: object mapping: $. - name: update-ad-2 description: Update an ad hints: readOnly: false destructive: false idempotent: true call: marketing-ads.updateadsad with: fields: tools.fields raw: tools.raw connection_id: tools.connection_id id: tools.id body: tools.body outputParameters: - type: object mapping: $. - name: list-all-campaigns description: List all campaigns hints: readOnly: true destructive: false idempotent: true call: marketing-ads.listadscampaigns with: limit: tools.limit offset: tools.offset updated_gte: tools.updated_gte sort: tools.sort order: tools.order query: tools.query org_id: tools.org_id start_gte: tools.start_gte end_lt: tools.end_lt fields: tools.fields raw: tools.raw connection_id: tools.connection_id outputParameters: - type: object mapping: $. - name: create-campaign description: Create a campaign hints: readOnly: false destructive: false idempotent: false call: marketing-ads.createadscampaign with: fields: tools.fields raw: tools.raw connection_id: tools.connection_id body: tools.body outputParameters: - type: object mapping: $. - name: remove-campaign description: Remove a campaign hints: readOnly: false destructive: true idempotent: true call: marketing-ads.removeadscampaign with: connection_id: tools.connection_id id: tools.id outputParameters: - type: object mapping: $. - name: retrieve-campaign description: Retrieve a campaign hints: readOnly: true destructive: false idempotent: true call: marketing-ads.getadscampaign with: fields: tools.fields raw: tools.raw connection_id: tools.connection_id id: tools.id outputParameters: - type: object mapping: $. - name: update-campaign description: Update a campaign hints: readOnly: false destructive: false idempotent: true call: marketing-ads.patchadscampaign with: fields: tools.fields raw: tools.raw connection_id: tools.connection_id id: tools.id body: tools.body outputParameters: - type: object mapping: $. - name: update-campaign-2 description: Update a campaign hints: readOnly: false destructive: false idempotent: true call: marketing-ads.updateadscampaign with: fields: tools.fields raw: tools.raw connection_id: tools.connection_id id: tools.id body: tools.body outputParameters: - type: object mapping: $. - name: list-all-creatives description: List all creatives hints: readOnly: true destructive: false idempotent: true call: marketing-ads.listadscreatives with: limit: tools.limit offset: tools.offset updated_gte: tools.updated_gte sort: tools.sort order: tools.order query: tools.query org_id: tools.org_id group_id: tools.group_id fields: tools.fields raw: tools.raw connection_id: tools.connection_id outputParameters: - type: object mapping: $. - name: create-creative description: Create a creative hints: readOnly: false destructive: false idempotent: false call: marketing-ads.createadscreative with: fields: tools.fields raw: tools.raw connection_id: tools.connection_id body: tools.body outputParameters: - type: object mapping: $. - name: remove-creative description: Remove a creative hints: readOnly: false destructive: true idempotent: true call: marketing-ads.removeadscreative with: connection_id: tools.connection_id id: tools.id outputParameters: - type: object mapping: $. - name: retrieve-creative description: Retrieve a creative hints: readOnly: true destructive: false idempotent: true call: marketing-ads.getadscreative with: fields: tools.fields raw: tools.raw connection_id: tools.connection_id id: tools.id outputParameters: - type: object mapping: $. - name: update-creative description: Update a creative hints: readOnly: false destructive: false idempotent: true call: marketing-ads.patchadscreative with: fields: tools.fields raw: tools.raw connection_id: tools.connection_id id: tools.id body: tools.body outputParameters: - type: object mapping: $. - name: update-creative-2 description: Update a creative hints: readOnly: false destructive: false idempotent: true call: marketing-ads.updateadscreative with: fields: tools.fields raw: tools.raw connection_id: tools.connection_id id: tools.id body: tools.body outputParameters: - type: object mapping: $. - name: list-all-groups description: List all groups hints: readOnly: true destructive: false idempotent: true call: marketing-ads.listadsgroups with: limit: tools.limit offset: tools.offset updated_gte: tools.updated_gte sort: tools.sort order: tools.order query: tools.query org_id: tools.org_id campaign_id: tools.campaign_id parent_id: tools.parent_id io_id: tools.io_id start_gte: tools.start_gte end_lt: tools.end_lt fields: tools.fields raw: tools.raw connection_id: tools.connection_id outputParameters: - type: object mapping: $. - name: create-group description: Create a group hints: readOnly: false destructive: false idempotent: false call: marketing-ads.createadsgroup with: fields: tools.fields raw: tools.raw connection_id: tools.connection_id body: tools.body outputParameters: - type: object mapping: $. - name: remove-group description: Remove a group hints: readOnly: false destructive: true idempotent: true call: marketing-ads.removeadsgroup with: connection_id: tools.connection_id id: tools.id outputParameters: - type: object mapping: $. - name: retrieve-group description: Retrieve a group hints: readOnly: true destructive: false idempotent: true call: marketing-ads.getadsgroup with: fields: tools.fields raw: tools.raw connection_id: tools.connection_id id: tools.id outputParameters: - type: object mapping: $. - name: update-group description: Update a group hints: readOnly: false destructive: false idempotent: true call: marketing-ads.patchadsgroup with: fields: tools.fields raw: tools.raw connection_id: tools.connection_id id: tools.id body: tools.body outputParameters: - type: object mapping: $. - name: update-group-2 description: Update a group hints: readOnly: false destructive: false idempotent: true call: marketing-ads.updateadsgroup with: fields: tools.fields raw: tools.raw connection_id: tools.connection_id id: tools.id body: tools.body outputParameters: - type: object mapping: $. - name: list-all-insertionorders description: List all insertionorders hints: readOnly: true destructive: false idempotent: true call: marketing-ads.listadsinsertionorders with: limit: tools.limit offset: tools.offset updated_gte: tools.updated_gte sort: tools.sort order: tools.order query: tools.query org_id: tools.org_id campaign_id: tools.campaign_id fields: tools.fields raw: tools.raw connection_id: tools.connection_id outputParameters: - type: object mapping: $. - name: create-insertionorder description: Create an insertionorder hints: readOnly: false destructive: false idempotent: false call: marketing-ads.createadsinsertionorder with: fields: tools.fields raw: tools.raw connection_id: tools.connection_id body: tools.body outputParameters: - type: object mapping: $. - name: remove-insertionorder description: Remove an insertionorder hints: readOnly: false destructive: true idempotent: true call: marketing-ads.removeadsinsertionorder with: connection_id: tools.connection_id id: tools.id outputParameters: - type: object mapping: $. - name: retrieve-insertionorder description: Retrieve an insertionorder hints: readOnly: true destructive: false idempotent: true call: marketing-ads.getadsinsertionorder with: fields: tools.fields raw: tools.raw connection_id: tools.connection_id id: tools.id outputParameters: - type: object mapping: $. - name: update-insertionorder description: Update an insertionorder hints: readOnly: false destructive: false idempotent: true call: marketing-ads.patchadsinsertionorder with: fields: tools.fields raw: tools.raw connection_id: tools.connection_id id: tools.id body: tools.body outputParameters: - type: object mapping: $. - name: update-insertionorder-2 description: Update an insertionorder hints: readOnly: false destructive: false idempotent: true call: marketing-ads.updateadsinsertionorder with: fields: tools.fields raw: tools.raw connection_id: tools.connection_id id: tools.id body: tools.body outputParameters: - type: object mapping: $. - name: list-all-organizations description: List all organizations hints: readOnly: true destructive: false idempotent: true call: marketing-ads.listadsorganizations with: limit: tools.limit offset: tools.offset updated_gte: tools.updated_gte sort: tools.sort order: tools.order query: tools.query parent_id: tools.parent_id fields: tools.fields raw: tools.raw connection_id: tools.connection_id outputParameters: - type: object mapping: $. - name: create-organization description: Create an organization hints: readOnly: false destructive: false idempotent: false call: marketing-ads.createadsorganization with: fields: tools.fields raw: tools.raw connection_id: tools.connection_id body: tools.body outputParameters: - type: object mapping: $. - name: remove-organization description: Remove an organization hints: readOnly: false destructive: true idempotent: true call: marketing-ads.removeadsorganization with: connection_id: tools.connection_id id: tools.id outputParameters: - type: object mapping: $. - name: retrieve-organization description: Retrieve an organization hints: readOnly: true destructive: false idempotent: true call: marketing-ads.getadsorganization with: fields: tools.fields raw: tools.raw connection_id: tools.connection_id id: tools.id outputParameters: - type: object mapping: $. - name: update-organization description: Update an organization hints: readOnly: false destructive: false idempotent: true call: marketing-ads.patchadsorganization with: fields: tools.fields raw: tools.raw connection_id: tools.connection_id id: tools.id body: tools.body outputParameters: - type: object mapping: $. - name: update-organization-2 description: Update an organization hints: readOnly: false destructive: false idempotent: true call: marketing-ads.updateadsorganization with: fields: tools.fields raw: tools.raw connection_id: tools.connection_id id: tools.id body: tools.body outputParameters: - type: object mapping: $. - name: list-all-promoteds description: List all promoteds hints: readOnly: true destructive: false idempotent: true call: marketing-ads.listadspromoteds with: limit: tools.limit offset: tools.offset updated_gte: tools.updated_gte sort: tools.sort order: tools.order query: tools.query org_id: tools.org_id type: tools.type fields: tools.fields raw: tools.raw connection_id: tools.connection_id outputParameters: - type: object mapping: $. - name: retrieve-promoted description: Retrieve a promoted hints: readOnly: true destructive: false idempotent: true call: marketing-ads.getadspromoted with: fields: tools.fields raw: tools.raw connection_id: tools.connection_id id: tools.id outputParameters: - type: object mapping: $. - name: list-all-reports description: List all reports hints: readOnly: true destructive: false idempotent: true call: marketing-ads.listadsreports with: limit: tools.limit offset: tools.offset updated_gte: tools.updated_gte sort: tools.sort order: tools.order query: tools.query org_id: tools.org_id campaign_id: tools.campaign_id group_id: tools.group_id ad_id: tools.ad_id type: tools.type start_gte: tools.start_gte end_lt: tools.end_lt fields: tools.fields raw: tools.raw connection_id: tools.connection_id outputParameters: - type: object mapping: $. - name: list-all-targets description: List all targets hints: readOnly: true destructive: false idempotent: true call: marketing-ads.listadstargets with: limit: tools.limit offset: tools.offset updated_gte: tools.updated_gte sort: tools.sort order: tools.order query: tools.query org_id: tools.org_id type: tools.type fields: tools.fields raw: tools.raw connection_id: tools.connection_id outputParameters: - type: object mapping: $. - name: retrieve-target description: Retrieve a target hints: readOnly: true destructive: false idempotent: true call: marketing-ads.getadstarget with: fields: tools.fields raw: tools.raw connection_id: tools.connection_id id: tools.id outputParameters: - type: object mapping: $.