v1Resources/Clients/postSend the client-portal invite
Send the client-portal invite
Send or resend an invitation to the primary contact, or provide clientUserId for a non-disabled user awaiting their first sign-in. No body retains the primary-contact behavior; malformed JSON is refused. Returns the sent portalLink. Previously issued links remain independently valid until used or their seven-day expiry. Requires the identified credential owner’s access to this client.
post
clients:write/api/v1/clients/{id}/inviteQuery parameters
idstringrequired
The client to invite.
Request body
clientUserIdstringoptional
Response
dataobjectoptional
portalLinkstringoptional
The magic-link URL that was sent in the invite email.
Errors
400The request is missing a required parameter or is otherwise malformed.
401Missing, invalid, expired, or revoked API key.
403The key lacks the required scope, or isn't authorized for this client/location.
404The resource wasn't found, or doesn't belong to your agency.
409The request conflicts with the current state of the resource — for example, changing the email or phone of a recipient who has already been messaged, or a team invite that was already accepted (or hasn't been accepted yet).
429Too many requests. Retry after the number of seconds in the Retry-After header.
503The service is temporarily unavailable. Retry a credit grant with the same idempotency key.
post/api/v1/clients/{id}/invite
Your API key
id *
Request body
{
"data": {
"portalLink": "https://portal.synup.com/invite/aB3dE9fGhJ"
}
}Guides that use this endpoint
- How to Build a Reputation Management PlatformArchitecture and API calls for a multi-client reputation management platform on Synup: review ingestion, reply workflows, invites, widgets and reporting.
- How to Add Local Marketing Features to Your SaaSAdd listings management, reviews, Google posts, profile analytics, rank tracking and AI visibility to a SaaS product with the Synup API, tenant by tenant.
- How to Build a White-Label Local Marketing PlatformBuild a multi-tenant white-label local marketing platform on the API, with client provisioning, team access, per-client summaries and scoped API keys.