{"components":{"callbacks":{},"examples":{},"headers":{},"links":{},"parameters":{"AccountIdHeaderOptional":{"description":"The identifier of an Amazon Ads Advertiser Account.","in":"header","name":"Amazon-Ads-AccountId","schema":{"type":"string"}},"ClientIdHeader":{"description":"The identifier of a client associated with a \u0027Login with Amazon\u0027 account.","in":"header","name":"Amazon-Ads-ClientId","required":true,"schema":{"type":"string"}},"ManagerAccountIdHeaderOptional":{"description":"The identifier of an Amazon Ads Manager Account.","in":"header","name":"Amazon-Ads-Manager-AccountId","schema":{"type":"string"}}},"requestBodies":{},"responses":{},"schemas":{"AmazonConsentFormat":{"description":"Captures information as to whether a user has consented to their data being used for advertising purposes.","properties":{"amznAdStorage":{"$ref":"#/components/schemas/ConsentStatus"},"amznUserData":{"$ref":"#/components/schemas/ConsentStatus"}},"required":["amznUserData"],"type":"object"},"BadGatewayResponseContent":{"properties":{"code":{"type":"string"},"message":{"type":"string"}},"required":["code","message"],"type":"object"},"BadRequestResponseContent":{"properties":{"code":{"$ref":"#/components/schemas/ErrorCode"},"message":{"type":"string"}},"required":["code","message"],"type":"object"},"Consent":{"description":"Describes consent given by the user associated with the conversion event to have their data used for advertising purposes. For EU advertisers, it is required to provide one of geo, amazonConsent, tcf, or gpp.","properties":{"amazonConsent":{"$ref":"#/components/schemas/AmazonConsentFormat"},"geo":{"$ref":"#/components/schemas/GeographicConsentData"},"gpp":{"description":"An encoded Global Privacy Platform (GPP) string describing what the user has consented to. This string encapsulates user privacy preferences and consent information in a compact format.","type":"string"},"tcf":{"description":"An encoded Transparency and Consent Framework (TCF) string describing what the user has consented to. This string contains information about user consent choices in a compressed format.","type":"string"}},"type":"object"},"ConsentStatus":{"description":"**ConsentStatus Enum:**\n| ConsentStatus | Description |\n| --- | --- |\n| `GRANTED` | Consent has been granted. |\n| `DENIED` | Consent has been denied. |","enum":["DENIED","GRANTED"],"type":"string"},"ContentTooLargeResponseContent":{"properties":{"code":{"$ref":"#/components/schemas/ErrorCode"},"message":{"type":"string"}},"required":["code","message"],"type":"object"},"ConversionType":{"description":"**ConversionType Enum:**\n| ConversionType | Description |\n| --- | --- |\n| `ADD_TO_SHOPPING_CART` | When customers add a product to their shopping cart. |\n| `APPLICATION` | When customers submit an application. |\n| `CHECKOUT` | When customers go to the checkout page. |\n| `CONTACT` | When customers provide contact information, such as email, phone number, etc. |\n| `LEAD` | When customers perform an action that initiates a sales lead. |\n| `OFF_AMAZON_PURCHASES` | When customers make a purchase for a service or product. |\n| `MOBILE_APP_FIRST_START` | When customers launch the downloaded app for the first time. |\n| `PAGE_VIEW` | When customers visit a page on your website. |\n| `SEARCH` | When customers perform a search for a product. |\n| `SIGN_UP` | When customers sign up for a product or service. |\n| `SUBSCRIBE` | When customers subscribe to your service. |\n| `OTHER` | Customer actions that don\u0027t fit the definition of the standard event types. |","enum":["ADD_TO_SHOPPING_CART","APPLICATION","CHECKOUT","CONTACT","LEAD","MOBILE_APP_FIRST_START","OFF_AMAZON_PURCHASES","OTHER","PAGE_VIEW","SEARCH","SIGN_UP","SUBSCRIBE"],"type":"string"},"CountryCode":{"enum":["AD","AE","AF","AG","AI","AL","AM","AO","AQ","AR","AS","AT","AU","AW","AX","AZ","BA","BB","BD","BE","BF","BG","BH","BI","BJ","BL","BM","BN","BO","BQ","BR","BS","BT","BV","BW","BY","BZ","CA","CC","CD","CF","CG","CH","CI","CK","CL","CM","CN","CO","CR","CU","CV","CW","CX","CY","CZ","DE","DJ","DK","DM","DO","DZ","EC","EE","EG","EH","ER","ES","ET","FI","FJ","FK","FM","FO","FR","GA","GB","GD","GE","GF","GG","GH","GI","GL","GM","GN","GP","GQ","GR","GS","GT","GU","GW","GY","HK","HM","HN","HR","HT","HU","ID","IE","IL","IM","IN","IO","IQ","IR","IS","IT","JE","JM","JO","JP","KE","KG","KH","KI","KM","KN","KP","KR","KW","KY","KZ","LA","LB","LC","LI","LK","LR","LS","LT","LU","LV","LY","MA","MC","MD","ME","MF","MG","MH","MK","ML","MM","MN","MO","MP","MQ","MR","MS","MT","MU","MV","MW","MX","MY","MZ","NA","NC","NE","NF","NG","NI","NL","NO","NP","NR","NU","NZ","OM","PA","PE","PF","PG","PH","PK","PL","PM","PN","PR","PS","PT","PW","PY","QA","RE","RO","RS","RU","RW","SA","SB","SC","SD","SE","SG","SH","SI","SJ","SK","SL","SM","SN","SO","SR","SS","ST","SV","SX","SY","SZ","TC","TD","TF","TG","TH","TJ","TK","TL","TM","TN","TO","TR","TT","TV","TW","TZ","UA","UG","UM","US","UY","UZ","VA","VC","VE","VG","VI","VN","VU","WF","WS","YE","YT","ZA","ZM","ZW","ZZ"],"type":"string"},"CreateAmazonConsentFormat":{"description":"Captures information as to whether a user has consented to their data being used for advertising purposes.","properties":{"amznAdStorage":{"$ref":"#/components/schemas/ConsentStatus"},"amznUserData":{"$ref":"#/components/schemas/ConsentStatus"}},"required":["amznUserData"],"type":"object"},"CreateConsent":{"description":"Describes consent given by the user associated with the conversion event to have their data used for advertising purposes. For EU advertisers, it is required to provide one of geo, amazonConsent, tcf, or gpp.","properties":{"amazonConsent":{"$ref":"#/components/schemas/CreateAmazonConsentFormat"},"geo":{"$ref":"#/components/schemas/CreateGeographicConsentData"},"gpp":{"description":"An encoded Global Privacy Platform (GPP) string describing what the user has consented to. This string encapsulates user privacy preferences and consent information in a compact format.","type":"string"},"tcf":{"description":"An encoded Transparency and Consent Framework (TCF) string describing what the user has consented to. This string contains information about user consent choices in a compressed format.","type":"string"}},"type":"object"},"CreateCustomData":{"description":"Custom data associated with the event to provide additional context.","properties":{"dataType":{"$ref":"#/components/schemas/DataType"},"name":{"description":"Name of the custom attribute. Only letters, numbers and the underscore character are allowed. e.g. brand, category, productId.","type":"string"},"value":{"description":"Value of the custom attribute. Only letters, numbers and the underscore character are allowed.","type":"string"}},"required":["name","value"],"type":"object"},"CreateDataProcessingOptions":{"description":"A list of data processing options.","properties":{"options":{"$ref":"#/components/schemas/DataProcessingOption"}},"type":"object"},"CreateDeviceInfo":{"description":"Device information associated with the conversion event.","properties":{"userAgent":{"description":"Raw user agent string from the browser or app at the time of the event. Max 512 characters.","type":"string"}},"type":"object"},"CreateEventDescription":{"description":"The composite key that uniquely identifies an event.","properties":{"conversionType":{"$ref":"#/components/schemas/ConversionType"},"dataSetName":{"description":"Event DataSet name to which this event should be added to.","pattern":"[A-Za-z][A-Za-z0-9_-]*","type":"string"},"eventIngestionMethod":{"$ref":"#/components/schemas/EventIngestionMethod"},"eventSource":{"$ref":"#/components/schemas/EventSource"},"name":{"description":"The name of the imported event.","type":"string"}},"required":["conversionType","eventIngestionMethod","eventSource","name"],"type":"object"},"CreateEventRequest":{"properties":{"events":{"items":{"$ref":"#/components/schemas/EventCreate"},"maxItems":500,"minItems":1,"type":"array"}},"required":["events"],"type":"object"},"CreateGeographicConsentData":{"description":"Captures the user\u0027s geographic information for purposes of consent checking.","properties":{"ipAddress":{"description":"IP address of the user associated with the conversion event.","type":"string"}},"required":["ipAddress"],"type":"object"},"CreateMatchKey":{"description":"The identifier used to match people for attribution. PII-based match key data needs to be normalized and hashed (SHA-256). REAL_ID, MERKLE_ID, KANTAR_ID, FIP, and AREF_TOKEN accept raw identifier values. Email addresses provided must follow the formatting guidelines: Lowercase, remove all non-alphanumeric characters [a-zA-Z0-9] and [.@-], and remove any leading or trailing whitespace.","properties":{"type":{"$ref":"#/components/schemas/MatchKeyType"},"values":{"description":"Identifier value of the customer who performed the event. SHA-256 hashed for PII-based keys; raw value for REAL_ID, MERKLE_ID, KANTAR_ID, FIP, and AREF_TOKEN.","items":{"type":"string"},"maxItems":1,"minItems":1,"type":"array"}},"required":["type","values"],"type":"object"},"CurrencyCode":{"description":"**CurrencyCode Enum:**\n| CurrencyCode | Description |\n| --- | --- |\n| `AED` | United Arab Emirates Dirham |\n| `AUD` | Australian Dollar |\n| `BRL` | Brazilian Real |\n| `CAD` | Canadian Dollar |\n| `CNY` | Chinese Yuan |\n| `DKK` | Danish Krone |\n| `EUR` | Euro |\n| `GBP` | British Pound Sterling |\n| `INR` | Indian Rupee |\n| `JPY` | Japanese Yen |\n| `MXN` | Mexican Peso |\n| `NOK` | Norwegian Krone |\n| `NZD` | New Zealand Dollar |\n| `SAR` | Saudi Riyal |\n| `SEK` | Swedish Krona |\n| `SGD` | Singapore Dollar |\n| `TRY` | Turkish Lira |\n| `USD` | United States Dollar |","enum":["AED","AUD","BRL","CAD","CNY","DKK","EUR","GBP","INR","JPY","MXN","NOK","NZD","SAR","SEK","SGD","TRY","USD"],"type":"string"},"CustomData":{"description":"Custom data associated with the event to provide additional context.","properties":{"dataType":{"$ref":"#/components/schemas/DataType"},"name":{"description":"Name of the custom attribute. Only letters, numbers and the underscore character are allowed. e.g. brand, category, productId.","type":"string"},"value":{"description":"Value of the custom attribute. Only letters, numbers and the underscore character are allowed.","type":"string"}},"required":["name","value"],"type":"object"},"DataProcessingOption":{"description":"**DataProcessingOption Enum:**\n| DataProcessingOption | Description |\n| --- | --- |\n| `LIMITED_DATA_USE` | Indicates that the event should be processed with limited data use. |","enum":["LIMITED_DATA_USE"],"type":"string"},"DataProcessingOptions":{"description":"A list of data processing options.","properties":{"options":{"$ref":"#/components/schemas/DataProcessingOption"}},"type":"object"},"DataType":{"description":"**DataType Enum:**\n| DataType | Description |\n| --- | --- |\n| `STRING` | String data type. |\n| `INTEGER` | 32-bit signed integer data type. |\n| `TIMESTAMP` | Timestamp data type. |","enum":["INTEGER","STRING","TIMESTAMP"],"type":"string"},"DeviceInfo":{"description":"Device information associated with the conversion event.","properties":{"userAgent":{"description":"Raw user agent string from the browser or app at the time of the event. Max 512 characters.","type":"string"}},"type":"object"},"Error":{"properties":{"code":{"$ref":"#/components/schemas/ErrorCode"},"fieldLocation":{"type":"string"},"message":{"type":"string"}},"required":["code","message"],"type":"object"},"ErrorCode":{"description":"**ErrorCode Enum:**\n| ErrorCode | Description |\n| --- | --- |\n| `INTERNAL_ERROR` | The server encountered an unexpected condition that prevented it from fulfilling the request. |\n| `UNAUTHORIZED` | The request lacks the necessary credentials. |\n| `FORBIDDEN` | The caller is not authorized to make the given request. |\n| `TOO_MANY_REQUESTS` | There have been too many requests, please slow down your call rate. |\n| `CONTENT_TOO_LARGE` | The request is too large. Consider splitting it into multiple requests. |\n| `NOT_FOUND` | The requested resource does not exist. |\n| `BAD_REQUEST` | The request is not valid considering the documented schema. |","enum":["BAD_REQUEST","CONTENT_TOO_LARGE","FORBIDDEN","INTERNAL_ERROR","NOT_FOUND","TOO_MANY_REQUESTS","UNAUTHORIZED"],"type":"string"},"ErrorsIndex":{"properties":{"errors":{"items":{"$ref":"#/components/schemas/Error"},"maxItems":20,"minItems":1,"type":"array"},"index":{"format":"int32","maximum":499,"minimum":0,"type":"integer"}},"required":["errors","index"],"type":"object"},"Event":{"properties":{"amazonAdEventKey":{"description":"Amazon Traffic identifier for post attributed events (if applicable).","type":"string"},"consent":{"$ref":"#/components/schemas/Consent"},"countryCode":{"$ref":"#/components/schemas/CountryCode"},"currencyCode":{"$ref":"#/components/schemas/CurrencyCode"},"customData":{"description":"Custom data associated with the event.","items":{"$ref":"#/components/schemas/CustomData"},"maxItems":13,"minItems":0,"type":"array"},"dataProcessingOptions":{"$ref":"#/components/schemas/DataProcessingOptions"},"deviceInfo":{"$ref":"#/components/schemas/DeviceInfo"},"eventDescription":{"$ref":"#/components/schemas/EventDescription"},"eventId":{"description":"The client specified id for the event. For events with the same eventId only the latest event will be kept.","type":"string"},"eventTime":{"description":"The reported timestamp of when the event occurred.","format":"date-time","type":"string"},"matchKeys":{"description":"Array representing the user and device identifier types/values to be used for attribution to traffic events. Match key value must be normalized and hashed, except for MAID, RAMP_ID, MATCH_ID, REAL_ID, MERKLE_ID, KANTAR_ID, FIP, and AREF_TOKEN. ADID, IDFA, or FIREADID can be passed into the MAID field for mobile identifiers.","items":{"$ref":"#/components/schemas/MatchKey"},"maxItems":15,"minItems":1,"type":"array"},"partner":{"description":"The name of the third-party service used to deliver the conversions (if applicable).","type":"string"},"unitsSold":{"description":"The number of items purchased. Only applicable for OFF_AMAZON_PURCHASES event type. If not provided on the event, a default of 1 will be applied.","format":"int32","type":"integer"},"value":{"description":"Represents value of the event. For OFF_AMAZON_PURCHASES conversionType, represents monetary value (min 0, max 2 decimals). For other conversionTypes, represents non-monetary value on your chosen scale (can be negative, max 2 decimals). Uses template default if not provided.","format":"double","type":"number"}},"required":["countryCode","eventDescription","eventTime","matchKeys"],"type":"object"},"EventCreate":{"properties":{"amazonAdEventKey":{"description":"Amazon Traffic identifier for post attributed events (if applicable).","type":"string"},"consent":{"$ref":"#/components/schemas/CreateConsent"},"countryCode":{"$ref":"#/components/schemas/CountryCode"},"currencyCode":{"$ref":"#/components/schemas/CurrencyCode"},"customData":{"description":"Custom data associated with the event.","items":{"$ref":"#/components/schemas/CreateCustomData"},"maxItems":13,"minItems":0,"type":"array"},"dataProcessingOptions":{"$ref":"#/components/schemas/CreateDataProcessingOptions"},"deviceInfo":{"$ref":"#/components/schemas/CreateDeviceInfo"},"eventDescription":{"$ref":"#/components/schemas/CreateEventDescription"},"eventId":{"description":"The client specified id for the event. For events with the same eventId only the latest event will be kept.","type":"string"},"eventTime":{"description":"The reported timestamp of when the event occurred.","format":"date-time","type":"string"},"matchKeys":{"description":"Array representing the user and device identifier types/values to be used for attribution to traffic events. Match key value must be normalized and hashed, except for MAID, RAMP_ID, MATCH_ID, REAL_ID, MERKLE_ID, KANTAR_ID, FIP, and AREF_TOKEN. ADID, IDFA, or FIREADID can be passed into the MAID field for mobile identifiers.","items":{"$ref":"#/components/schemas/CreateMatchKey"},"maxItems":15,"minItems":1,"type":"array"},"partner":{"description":"The name of the third-party service used to deliver the conversions (if applicable).","type":"string"},"unitsSold":{"description":"The number of items purchased. Only applicable for OFF_AMAZON_PURCHASES event type. If not provided on the event, a default of 1 will be applied.","format":"int32","type":"integer"},"value":{"description":"Represents value of the event. For OFF_AMAZON_PURCHASES conversionType, represents monetary value (min 0, max 2 decimals). For other conversionTypes, represents non-monetary value on your chosen scale (can be negative, max 2 decimals). Uses template default if not provided.","format":"double","type":"number"}},"required":["countryCode","eventDescription","eventTime","matchKeys"],"type":"object"},"EventDescription":{"description":"The composite key that uniquely identifies an event.","properties":{"conversionType":{"$ref":"#/components/schemas/ConversionType"},"dataSetName":{"description":"Event DataSet name to which this event should be added to.","pattern":"[A-Za-z][A-Za-z0-9_-]*","type":"string"},"eventIngestionMethod":{"$ref":"#/components/schemas/EventIngestionMethod"},"eventSource":{"$ref":"#/components/schemas/EventSource"},"name":{"description":"The name of the imported event.","type":"string"}},"required":["conversionType","eventIngestionMethod","eventSource","name"],"type":"object"},"EventIngestionMethod":{"description":"**EventIngestionMethod Enum:**\n| EventIngestionMethod | Description |\n| --- | --- |\n| `SERVER_TO_SERVER` | Events tracked with the events import API. |","enum":["SERVER_TO_SERVER"],"type":"string"},"EventMultiStatusResponse":{"properties":{"error":{"items":{"$ref":"#/components/schemas/ErrorsIndex"},"maxItems":500,"minItems":0,"type":"array"},"success":{"items":{"$ref":"#/components/schemas/EventMultiStatusSuccess"},"maxItems":500,"minItems":0,"type":"array"}},"type":"object"},"EventMultiStatusSuccess":{"properties":{"event":{"$ref":"#/components/schemas/Event"},"index":{"format":"int32","maximum":499,"minimum":0,"type":"integer"}},"required":["event","index"],"type":"object"},"EventSource":{"description":"**EventSource Enum:**\n| EventSource | Description |\n| --- | --- |\n| `ANDROID` | Events from a mobile application on the Android operating system. |\n| `FIRE_TV` | Events from a mobile application on the Fire TV operating system. |\n| `IOS` | Events from a mobile application on the iOS operating system. |\n| `OFFLINE` | Events captured and reported via an offline mechanism. These could be events from in-store purchases, in-office activities, etc. |\n| `WEBSITE` | Events tracked on a website. |\n| `MEASUREMENT_ATTRIBUTION_PARTNER` | Events from a 3P measurement attribution partner. |","enum":["ANDROID","FIRE_TV","IOS","MEASUREMENT_ATTRIBUTION_PARTNER","OFFLINE","WEBSITE"],"type":"string"},"ForbiddenResponseContent":{"properties":{"code":{"$ref":"#/components/schemas/ErrorCode"},"message":{"type":"string"}},"required":["code","message"],"type":"object"},"GatewayTimeoutResponseContent":{"properties":{"code":{"type":"string"},"message":{"type":"string"}},"required":["code","message"],"type":"object"},"GeographicConsentData":{"description":"Captures the user\u0027s geographic information for purposes of consent checking.","properties":{"ipAddress":{"description":"IP address of the user associated with the conversion event.","type":"string"}},"required":["ipAddress"],"type":"object"},"InternalServerErrorResponseContent":{"properties":{"code":{"type":"string"},"message":{"type":"string"}},"required":["code","message"],"type":"object"},"MatchKey":{"description":"The identifier used to match people for attribution. PII-based match key data needs to be normalized and hashed (SHA-256). REAL_ID, MERKLE_ID, KANTAR_ID, FIP, and AREF_TOKEN accept raw identifier values. Email addresses provided must follow the formatting guidelines: Lowercase, remove all non-alphanumeric characters [a-zA-Z0-9] and [.@-], and remove any leading or trailing whitespace.","properties":{"type":{"$ref":"#/components/schemas/MatchKeyType"},"values":{"description":"Identifier value of the customer who performed the event. SHA-256 hashed for PII-based keys; raw value for REAL_ID, MERKLE_ID, KANTAR_ID, FIP, and AREF_TOKEN.","items":{"type":"string"},"maxItems":1,"minItems":1,"type":"array"}},"required":["type","values"],"type":"object"},"MatchKeyType":{"description":"**MatchKeyType Enum:**\n| MatchKeyType | Description |\n| --- | --- |\n| `EMAIL` | Email address match key type. |\n| `PHONE` | Phone number match key type. |\n| `FIRST_NAME` | First name match key type. |\n| `LAST_NAME` | Last name match key type. |\n| `ADDRESS` | Address match key type. |\n| `CITY` | City match key type. |\n| `STATE` | State match key type. |\n| `POSTAL` | Postal code match key type. |\n| `MAID` | Mobile advertising ID match key type. |\n| `RAMP_ID` | RAMP ID match key type. |\n| `MATCH_ID` | Match ID key type. |\n| `REAL_ID` | RealId (AXM) identifier. |\n| `MERKLE_ID` | Merkle (MKL) identifier. |\n| `KANTAR_ID` | Kantar (KAN) identifier. |\n| `FIP` | Full IP address match key type. Supports IPv4 and IPv6. Used for identity resolution. |","enum":["ADDRESS","CITY","EMAIL","FIP","FIRST_NAME","KANTAR_ID","LAST_NAME","MAID","MATCH_ID","MERKLE_ID","PHONE","POSTAL","RAMP_ID","REAL_ID","STATE"],"type":"string"},"NotFoundResponseContent":{"properties":{"code":{"$ref":"#/components/schemas/ErrorCode"},"message":{"type":"string"}},"required":["code","message"],"type":"object"},"ServiceUnavailableErrorResponseContent":{"properties":{"code":{"type":"string"},"message":{"type":"string"}},"required":["code","message"],"type":"object"},"TooManyRequestsResponseContent":{"properties":{"code":{"$ref":"#/components/schemas/ErrorCode"},"message":{"type":"string"}},"required":["code","message"],"type":"object"},"UnauthorizedResponseContent":{"properties":{"code":{"$ref":"#/components/schemas/ErrorCode"},"message":{"type":"string"}},"required":["code","message"],"type":"object"}},"securitySchemes":{"OAuth2":{"flows":{"authorizationCode":{"authorizationUrl":"https://www.amazon.com/ap/oa","scopes":{"advertising::audiences":"Grants access to data provider APIs","advertising::campaign_management":"Grants write access to campaign management.","advertising::test:create_account":"Grants write access to create test accounts functionality","cpc_advertising:campaign_management":"Grants write access to campaign management. Legacy name (no difference from advertising::campaign_management)"},"tokenUrl":"https://api.amazon.com/auth/o2/token"}},"type":"oauth2"}}},"info":{"description":"Amazon Ads API v1 is a reimagined approach to our Ads API, built to provide a seamless experience across all Amazon advertising products through a common model. [Learn more about Ads API v1.](https://advertising.amazon.com/API/docs/en-us/reference/amazon-ads/overview) To learn about prerequisites and header values, see [Getting started with Amazon Ads API v1](https://advertising.amazon.com/API/docs/en-us/reference/amazon-ads/getting-started).\n\n**Download Amazon Ads API V1 OpenAPI Spec** ([All Products](https://d1y2lf8k3vrkfu.cloudfront.net/openapi/en-us/dest/AmazonAdsAPIALLMerged_prod_3p_ALL.json) | [SP](https://d1y2lf8k3vrkfu.cloudfront.net/openapi/en-us/dest/AmazonAdsAPISPMerged_prod_3p_ALL.json) | [SP Global](https://d1y2lf8k3vrkfu.cloudfront.net/openapi/en-us/dest/AmazonAdsAPISPGLOBALMerged_prod_3p_ALL.json) | [SB](https://d1y2lf8k3vrkfu.cloudfront.net/openapi/en-us/dest/AmazonAdsAPISBMerged_prod_3p_ALL.json) | [DSP](https://d1y2lf8k3vrkfu.cloudfront.net/openapi/en-us/dest/AmazonAdsAPIDSPMerged_prod_3p_ALL.json) | [ST](https://d1y2lf8k3vrkfu.cloudfront.net/openapi/en-us/dest/AmazonAdsAPISTMerged_prod_3p_ALL.json) | [SD](https://d1y2lf8k3vrkfu.cloudfront.net/openapi/en-us/dest/AmazonAdsAPISDMerged_prod_3p_ALL.json))","title":"Events API","version":"3.0"},"openapi":"3.0.1","paths":{"/adsApi/v1/create/events":{"post":{"description":"Create Event Data\n\n**Requires one of these permissions**:\n[\"event_manager_view\", \"event_manager_edit\", \"MasterAccount_Manager\"]","operationId":"CreateEvent","parameters":[{"$ref":"#/components/parameters/AccountIdHeaderOptional"},{"$ref":"#/components/parameters/ClientIdHeader"},{"$ref":"#/components/parameters/ManagerAccountIdHeaderOptional"}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateEventRequest"}}},"required":true},"responses":{"207":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/EventMultiStatusResponse"}}},"description":"CreateEvent 207 response"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BadRequestResponseContent"}}},"description":"BadRequest 400 response"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UnauthorizedResponseContent"}}},"description":"Unauthorized 401 response"},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ForbiddenResponseContent"}}},"description":"Forbidden 403 response"},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/NotFoundResponseContent"}}},"description":"NotFound 404 response"},"413":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ContentTooLargeResponseContent"}}},"description":"ContentTooLarge 413 response"},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TooManyRequestsResponseContent"}}},"description":"TooManyRequests 429 response"},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/InternalServerErrorResponseContent"}}},"description":"InternalServerError 500 response"},"502":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BadGatewayResponseContent"}}},"description":"BadGateway 502 response"},"503":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ServiceUnavailableErrorResponseContent"}}},"description":"ServiceUnavailableError 503 response"},"504":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GatewayTimeoutResponseContent"}}},"description":"GatewayTimeout 504 response"}},"security":[{"OAuth2":["advertising::campaign_management"]}],"tags":["Events"]}}},"servers":[{"description":"Production server for NA","url":"https://advertising-api.amazon.com"},{"description":"Production server for EU","url":"https://advertising-api-eu.amazon.com"},{"description":"Production server for FE","url":"https://advertising-api-fe.amazon.com"}]}