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

# Create Ads

> Create and manage sponsored advertisements

Create banner ads and sponsored content for your campaigns.

## Ad Types

| Type        | Dimensions | Placement      |
| ----------- | ---------- | -------------- |
| Leaderboard | 728x90     | Page header    |
| Sidebar     | 300x250    | Side content   |
| Inline      | 728x90     | Within content |
| Mobile      | 320x50     | Mobile pages   |

## Create Ad

<Steps>
  <Step title="Select Type">
    Choose ad format and dimensions
  </Step>

  <Step title="Upload Creative">
    Upload image or HTML5 creative
  </Step>

  <Step title="Set Destination">
    Enter click-through URL
  </Step>

  <Step title="Configure Targeting">
    Select pages, events, or member segments
  </Step>

  <Step title="Review & Submit">
    Preview and submit for approval
  </Step>
</Steps>

## Sponsorship credits

Ads can be billed using **sponsorship credits**:

* Each ad has a calculated credit cost based on placement + date range
* Credits are deducted when the ad is approved and goes live
* If you do not have enough credits, you must purchase a top-up before submitting/activating the ad

## Ad Management

* View active ads
* Pause/resume ads
* Update creatives
* View performance

## Features

### Create Ads

#### Acceptance Criteria

##### Frontend

* [ ] UI supports the workflows described in this feature.

##### Backend / API

* [ ] Backend behavior supports this feature as documented.

##### Permissions

* [ ] Access is restricted per the Capabilities matrix on this page (or equivalent role rules).

##### Business Rules

* [ ] All business rules for this feature are enforced.

##### Error Handling

* [ ] Error states return clear messages and appropriate HTTP status codes.

## Implementation Contracts

### Backend (API)

```
GET    /api/sponsor/ads                      # List ads
POST   /api/sponsor/ads                      # Create ad
PUT    /api/sponsor/ads/{id}                 # Update ad
DELETE /api/sponsor/ads/{id}                 # Remove ad
PUT    /api/sponsor/ads/{id}/status          # Pause/resume
GET    /api/sponsor/ads/{id}/stats           # Ad performance
```