<!--
{
  "availability" : [
    "Apple Ads Platform API: 1.0.0 -"
  ],
  "documentType" : "symbol",
  "framework" : "Apple-Ads-Platform-API",
  "identifier" : "/documentation/Apple-Ads-Platform-API/Apply-target-CPA-recommendations",
  "metadataVersion" : "0.1.0",
  "role" : "Web Service Endpoint",
  "symbol" : {
    "kind" : "Web Service Endpoint",
    "modules" : [
      "Apple Ads Platform API"
    ],
    "preciseIdentifier" : "rest:apple-ads-platform-api:post:recommendations-target-cpas-apply"
  },
  "title" : "Apply Target CPA Recommendations"
}
-->

# Apply Target CPA Recommendations

Apply one or more target CPA recommendations.

## Discussion

Applying a target CPA recommendation applies the recommendation’s `recommendedTargetCPA` value and moves the recommendation to `APPLIED` state. You can override the suggested value by passing `appliedTargetCPA` in the request. The response is a history record with both the recommended and applied values, plus the performance context behind the recommendation.

## Payload Examples

This example applies a target CPA recommendation, overriding the suggested CPA with $5.00. The response confirms the recommendation is now `APPLIED`.

**Apply Target CPA Recommendation:**

### Request

```json
POST /v1/recommendations/target-cpas/apply

[
 {
   "id": "rec-tcpa-001",
   "appliedTargetCPA": {
     "amount": "5.00",
     "currency": "USD"
   },
   "promotedObjectId": "123456",
   "promotedObjectType": "APPSTORE_APP"
 }
]
```

### Response

```json
{
 "result": [
   {
     "recommendationId": "rec-tcpa-001",
     "recommendationType": "TCPA",
     "promotedObjectId": "123456",
     "promotedObjectType": "APPSTORE_APP",
     "campaignId": 789012,
     "state": "APPLIED",
     "appliedTargetCPA": {
       "amount": "5.00",
       "currency": "USD"
     },
     "appliedTime": "2026-02-23T14:30:00Z"
   }
 ],
 "pagination": {
   "totalCount": 1,
   "offset": 0,
   "pageSize": 20
 }
}
```

---

Copyright &copy; 2026 Apple Inc. All rights reserved. | [Terms of Use](https://www.apple.com/legal/internet-services/terms/site.html) | [Privacy Policy](https://www.apple.com/privacy/privacy-policy)