ad_accounts14

ad_groups13

ads10

advanced_auction2

audience_insights2

audience_sharing7

audiences4

billing11

boards11

bulk3

business_access_assets12

business_access_invite6

business_access_relationships9

campaigns8

catalog_feeds8

catalog_items3

catalog_product_groups10

catalog_reports3

catalog_supplemental7

catalogs3

conversion_deletion_requests4

conversion_eqs1

conversion_events1

conversion_tags5

conversions4

customer_list_uploads3

customer_lists4

customer_segment3

integrations7

keywords5

labels5

lead_ads4

lead_forms5

leads_export2

media3

msot_events1

notification1

oauth3

order_lines2

pins8

product_group_promotions5

product_tags3

promotions5

resources6

schedules3

search3

targeting_template3

terms2

terms_of_service1

trends4

user_account14

business_access_invite

Accept or decline an invite/request

Changed on Jun 4, 2026

Accept or decline invites or requests.

patch/businesses/invites

Request

Base URL
https://api.pinterest.com/v5
Auth
OAuth 2
Authorization codehttps://www.pinterest.com/oauth/
Token URLhttps://api.pinterest.com/v5/oauth/token
Scopesbiz_access:read, biz_access:write
TypeScript
https://skmtc.dev/pinterest/apis/pinterest-rest-api/docs/businesses/invites/patch.ts
A function with typed inputs. Its response is checked against the schema.

Request body

Example request

{
  "invites": [
    {
      "action": {
        "asset_id_to_permissions": {
          "549760723247": [
            "ANALYST"
          ],
          "549760723248": [
            "ANALYST",
            "ADMIN"
          ],
          "809944451643622187": [
            "PROFILE_PUBLISHER"
          ]
        }
      }
    }
  ]
}

Response

The request has succeeded.

Example response

{
  "items": [
    {
      "exception": {
        "code": 403,
        "invite_or_request_id": "383791336903426391",
        "message": "You hit the maximum number of pending invites allowed.",
        "users_or_partner_ids": [
          "businessMember0101",
          "business+member@business.com"
        ]
      },
      "invite": {
        "id": "383791336903426391",
        "user": {
          "email": "business0101@business.com",
          "id": "549755885175",
          "username": "business0101"
        }
      }
    }
  ]
}

Changes

Jun 4, 2026v5b698c180678a Revision changes
- breaking
  the // response's property type changed from object to no type for status
- warning
  removed the optional property /// from the response with the status
- warning
  removed the optional property /// from the response with the status
- warning
  removed the optional property /// from the response with the status
- warning
  removed the optional property /// from the response with the status
- info
  added the new BIZ_PINNER_LIST_SHARER enum value to the request property /////
- info
  added the non-success response with the status
- info
  added the non-success response with the status
- info
  added the non-success response with the status
- info
  added the non-success response with the status
- info
  added the non-success response with the status
- info
  added to the // response property allOf list for the response status
Jul 16, 2025v543134ca41f18 Revision changes
- info
  added the new CONSUMER_USER enum value to the request property /////

Operation history (4 revisions)