Platform guide
Requires a Pinterest account with at least one board and permission to create Pins.
approval required500 characters1 media item
Capabilities at a glance
AnalyticsSupportedCommentsNot availableMessagesNot availableRemote deletionSupportedToken refreshSupported
01
Connect Pinterest
Create the hosted connection URL on your server. The customer completes OAuth or the provider-specific credential form directly on PostGate.
Connection requestPostGate API
curl -X POST https://postgate.studio/api/profiles/connect \
-H "Authorization: Bearer $POSTGATE_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"platform": "pinterest",
"profile_group_id": "grp_acme123",
"return_url": "https://app.example.com/settings/social"
}'02
Publish to Pinterest
Use the connected profile ID as the target. Provider-specific fields live under post.options.pinterest so the unified envelope remains stable.
Post envelopePostGate API
{
"post": {
"body": "Launch day.",
"options": {
"pinterest": {
"board_id": "BOARD_ID",
"title": "Launch story"
}
}
},
"profiles": [
"pro_pinterest123"
],
"media": [
"med_01JXYZ"
]
}03
Media and content limits
PostGate validates the request at creation and again at delivery. Account-level provider limits can be narrower than the general contract.
Text500 characters
LinksAllowed
Mediaimages and video · Up to 1
Image size32 MB
Video size2 GB
Video duration4 sec–15 min
04
Operational notes
These constraints affect approval, connection health, or delivery behavior for this provider.
A board ID is required.
Standard access requires review.
Check live capability before showing the option
Call
GET /api/platforms. A provider appears only when it is enabled and configured for the current workspace.