Skip to main content
PATCH
/
v2
/
integrations
/
{id}
Update Gmail Integration
curl --request PATCH \
  --url https://api.village.do/v2/integrations/{id} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "email_sending_per_day": 50,
  "email_sending_per_hour": 20,
  "email_sending_min_delay_seconds": 600,
  "timezone": "America/New_York",
  "status": "connected",
  "email_sending_default": false
}
'
{
  "data": {
    "id": 123,
    "type": "google",
    "account_identifier": "[email protected]",
    "status": "connected",
    "authorized_gmail": true,
    "email_sending_per_day": 50,
    "email_sending_per_hour": 20,
    "email_sending_min_delay_seconds": 600,
    "timezone": "America/New_York",
    "email_sending_default": true
  },
  "metadata": {
    "request_id": "<string>"
  }
}

Authorizations

​
Authorization
string
header
required

JWT token obtained from authentication endpoint

Path Parameters

​
id
string
required

Integration ID

Body

application/json
​
email_sending_per_day
number

Daily email sending limit

Required range: 1 <= x <= 500
Example:

50

​
email_sending_per_hour
number

Hourly email sending limit

Required range: 1 <= x <= 100
Example:

20

​
email_sending_min_delay_seconds
number

Minimum delay between emails in seconds

Required range: 60 <= x <= 3600
Example:

600

​
timezone
string

Timezone for scheduling

Example:

"America/New_York"

​
status
enum<string>

Integration status

Available options:
connected,
disconnected,
failed
Example:

"connected"

​
email_sending_default
boolean

Whether this should be the default integration for email sending

Example:

false

Response

Integration updated successfully

​
data
object
required

Updated Gmail integration details

​
metadata
object
required