Initiate Google OAuth login flow

POST

https://api.plusvibe.ai/v1/webhook/partner-google-oauth-url

These endpoints allow email infrastructure provider partners to programmatically initiate the Google/Microsoft OAuth login flow to add an account to PlusVibe.
Infrastructure provider is required to have its own browser automation

Authentication: two options, use whichever fits your setup:

API key — send your PlusVibe API key in the x-api-key header. pipl_username and pipl_password are not needed.

Username / password — pass pipl_username + pipl_password instead of the header.

Request

Body Params application/json

Examples

Responses

🟢200OK

application/json

Successfully generated redirect URL for OAuth

Bodyapplication/json

Request Example

Shell

JavaScript

Java

Swift

curl --location 'https://api.plusvibe.ai/v1/webhook/partner-google-oauth-url' \
--header 'Content-Type: application/json' \
--data '{
    "flow": "app_user",
    "workspace_id": "65099a0dd96fae8ab61120c0",
    "provider_id": "6a4a432f257de545d3947f3f",
    "min_interval": 4,
    "daily_limit": 30,
    "enable_camp_rampup": "yes",
    "camp_ramup_start": 4,
    "camp_rampup_increment": 2,
    "enable_warmup": "yes",
    "warmup_daily_limit": 20,
    "enable_warmup_rampup": "yes",
    "warmup_rampup_start": 5,
    "warmup_rampup_increment": 1
}'

Response Example

{
    "code": 1,
    "message": "success",
    "data": {
        "redirect_url": "https://accounts.google.com/o/oauth2/v2/auth?access_type=offline&prompt=consent&include_granted_scopes=true&scope=profile%20email%20https%3A%2F%2Fmail.google.com&state=...&response_type=code&client_id=...&redirect_uri=...",
        "client_id": "550255402234-v3e4mu3ugkvrl2ngaai0nnsv5nll1nm7.apps.googleusercontent.com"
    }
}

Modified at 2026-08-19 16:09:13

Check if an email exists in another workspace

Initiate Microsoft OAuth login flow