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

# Pinterest

> Turn App Store screenshots into Pinterest pins, schedule posts, and run screenshot automations that draft copy for you.

**Pinterest Growth** helps you turn App Store screenshots and marketing images into discoverable pins that drive traffic to your app. Connect your Pinterest account, compose or automate pins, and schedule them from the Appeeky dashboard.

<Info>
  Requires a signed-in Appeeky account. Connect Pinterest before posting or scheduling.
</Info>

***

## How it works

```
Connect Pinterest  →  pick board  →  add screenshot + copy  →  publish now or schedule
                                                                      │
                                                            pin goes live on Pinterest
```

* **Manual posts** — compose in the dashboard with an image, title/description, board, and destination link (App Store, Play Store, or App Gallery URL).
* **Automations** — rotate through your tracked app's App Store screenshots; each run drafts one pin with AI-generated copy for you to review.
* **Scheduled posts** — queue pins for a future time; Appeeky publishes them automatically when due.
* **Analytics** — after publish, see impressions, saves, and clicks in the dashboard or via the API.

For TikTok slideshows, X, and LinkedIn, use the same **Social Media** dashboard.

***

## Connect Pinterest

In the dashboard: **Settings → Social Media** or **Growth → Social Media → Accounts**, then connect Pinterest.

| Method | Endpoint                                           | Description                                     |
| ------ | -------------------------------------------------- | ----------------------------------------------- |
| GET    | `/v1/connect/social/platforms`                     | List supported platforms                        |
| GET    | `/v1/connect/social/pinterest/oauth/start`         | Returns `authorizeUrl` (`?return_to=` optional) |
| GET    | `/v1/connect/social/accounts`                      | List connected accounts                         |
| GET    | `/v1/connect/social/accounts/:id/pinterest/boards` | List boards for the board picker                |
| DELETE | `/v1/connect/social/accounts/:id`                  | Disconnect                                      |

On first connect, if your account has no boards yet, Appeeky creates a default **Appeeky** board and uses it when you don't pick one.

***

## Create a pin

| Method | Endpoint                         | Description                                   |
| ------ | -------------------------------- | --------------------------------------------- |
| POST   | `/v1/social/posts`               | Create post (publish now or schedule)         |
| POST   | `/v1/social/posts/:id/publish`   | Publish a draft or scheduled post immediately |
| GET    | `/v1/social/posts/:id`           | Get post and platform status                  |
| GET    | `/v1/social/posts/:id/analytics` | Pin metrics after publish                     |
| DELETE | `/v1/social/posts/:id`           | Cancel draft or scheduled post                |
| POST   | `/v1/social/media/upload`        | Upload image to your content library          |

### Request body

```json theme={"theme":{"light":"github-light","dark":"github-dark"}}
POST /v1/social/posts
{
  "content": "Dibble — habit tracker for ADHD\nBuild tiny routines without overwhelm. Tap to download.",
  "account_ids": ["social-media-account-uuid"],
  "media_ids": ["asset-uuid"],
  "scheduled_for": "2026-07-22T09:00:00.000Z",
  "timezone": "Europe/Istanbul",
  "extra": {
    "boardId": "pinterest-board-id",
    "link": "https://apps.apple.com/app/id123456789"
  }
}
```

| Field                       | Required    | Notes                                                        |
| --------------------------- | ----------- | ------------------------------------------------------------ |
| `content`                   | Yes         | First line → pin **title**; rest → **description**           |
| `account_ids`               | Yes         | Pinterest account id from `/connect/social/accounts`         |
| `media_ids` or `media_urls` | Yes         | At least one image (or video for video pins)                 |
| `scheduled_for`             | No          | Omit to publish immediately                                  |
| `extra.boardId`             | No          | Board id; uses your default board if omitted                 |
| `extra.link`                | Recommended | Destination URL (App Store, Play Store, or App Gallery page) |

### Pin media

* **Image pins** — one image from your library or upload.
* **Video pins** — video plus a cover image (`extra.coverImageUrl`).

***

## Automations (screenshot → pin)

| Method | Endpoint                              | Description                       |
| ------ | ------------------------------------- | --------------------------------- |
| GET    | `/v1/social/automations`              | List automations                  |
| POST   | `/v1/social/automations`              | Create automation                 |
| PATCH  | `/v1/social/automations/:id`          | Update schedule, pause, or resume |
| DELETE | `/v1/social/automations/:id`          | Archive                           |
| POST   | `/v1/social/automations/:id/generate` | Generate a draft pin now (202)    |

### Create Pinterest automation

```json theme={"theme":{"light":"github-light","dark":"github-dark"}}
POST /v1/social/automations
{
  "platform": "pinterest",
  "user_app_id": "tracked-app-uuid",
  "account_id": "pinterest-social-account-uuid",
  "name": "Dibble Pinterest pins",
  "schedule_crons": ["0 9 * * 1,3,5"],
  "timezone": "Europe/Istanbul",
  "review_mode": true,
  "draft_mode": true,
  "publish_config": {
    "boardId": "optional-board-id",
    "link": "https://apps.apple.com/app/id123456789"
  }
}
```

Each run:

1. Pulls the next iPhone screenshot from your tracked app.
2. Writes pin title and description with AI.
3. Saves a **draft** in the dashboard for you to review before publishing.

***

## Dashboard

Route: **`/dashboard/social-media`**

| Tab             | Purpose                                    |
| --------------- | ------------------------------------------ |
| **Calendar**    | Scheduled and published posts              |
| **All posts**   | Status, errors, publish now                |
| **Accounts**    | Connect Pinterest                          |
| **Automations** | Pinterest pin series and TikTok slideshows |
| **Library**     | Reuse uploaded screenshots                 |

***

## Related

* [Growth Channels overview](/docs/growth-channels)
* [Reddit Growth](/docs/growth-channels-reddit) — community scanning and inbox replies