# Citrine Edit
Citrine Edit is a fashion and accessories content workflow for organizing style ideas and publishing selected content to Pinterest.
What Citrine Edit Supports
Citrine Edit is designed for fashion and accessories content, including:
- Jewelry and watches
- Handbags and small leather goods
- Accessories and outfit inspiration
- Gift guides and seasonal fashion edits
- Trend and styling content
The workflow helps an authorized user prepare a visual content idea, choose a destination board, publish a Pin when requested, and review the result returned by the integration.
Pinterest Connection
Citrine Edit uses Pinterest's official OAuth authorization flow. When a user chooses to connect Pinterest:
1. The user is sent to Pinterest's authorization page.
2. Pinterest shows the app name and the requested permissions.
3. The user reviews the permissions and chooses whether to give access.
4. Pinterest redirects the user back to the registered callback URL with an authorization code.
5. Citrine Edit exchanges that code for an access token through Pinterest's OAuth token endpoint.
6. The workflow uses the granted token to read eligible boards and Pins and, when explicitly requested by the user, create or manage a Pin.
7. The workflow displays the API response and the newly created or updated Pin result.
Citrine Edit requests only the scopes needed for the selected workflow, such as `boards:read`, `pins:read`, and `pins:write`. The exact permissions are shown on Pinterest's authorization screen before access is granted.
Example Workflow
A typical operation is:
1. Connect a Pinterest account through OAuth.
2. Read the user's eligible public boards.
3. Select the `Jewelry Collection` board or another available board.
4. Submit an approved fashion or accessories image with a title, description, and destination link.
5. Create the Pin through Pinterest's official API.
6. Display the returned Pin ID, board, title, and media result for verification.
Citrine Edit does not receive the user's Pinterest password. Access can be revoked through Pinterest settings.
