business_access_invite
Update invite/request with an asset permission
Assign asset permissions information to an existing invite/request. Can be used to:
- Request access to a partner's asset. Note: This is only for when no existing partnership exists. If an existing
partnership exists, use "Create a request to access an existing partner's assets" to request access to your
partner's assets.
- invite_type="PARTNER_REQUEST"
- Invite a partner to access your business assets. Note: This is only for when there is no existing partnership.
If there is an existing partnership, use "Assign/Update partner asset permissions" to assign a partner access to
new assets.
- invite_type="PARTNER_INVITE"
- Invite a member to access your business assets. Note: This is only for when there is no existing membership.
If there is an existing membership, use "Assign/Update member asset permissions" to assign a member access to new
assets.
- invite_type="MEMBER_INVITE"
To learn more about permission levels, visit https://help.pinterest.com/en/business/article/business-manager-overview.
post/businesses/{business_id}/invites/assets/access
Path parameters
business_idstring required
Unique identifier of the requesting business.
Request body
Example request
{
"invites": [
{
"asset_id_to_permissions": {
"549760723247": [
"ANALYST"
],
"549760723248": [
"ANALYST",
"ADMIN"
],
"809944451643622187": [
"PROFILE_PUBLISHER"
]
},
"invite_id": "1234567890123",
"invite_type": "MEMBER_INVITE"
}
]
}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": {
"created_by_business_id": "1234567890123",
"created_by_user_id": "1234567890123",
"id": "383791336903426391",
"user": {
"email": "business0101@business.com",
"id": "549755885175",
"username": "business0101"
}
}
}
]
}