Connections

Refresh connection

Refresh the connection access token when it is stale and return the connection.

post/orgs/connections/{connection_id}/refresh

Request

  • Base URL: https://api.useinvent.com
  • URL: https://api.useinvent.com/orgs/connections/{connection_id}/refresh
  • Auth: HTTP bearer

Path parameters

connection_idstring required

The ID of the connection

Response

The refreshed connection.

idstring required

Unique identifier for the connection

type'SCHEDULER' | 'WORKFLOWS' | 'TOOLS' | 'FILES' | 'EMAILS' | 'HTTP_CREDENTIALS' | 'TABLES' | 'PAGES' | 'KNOWLEDGE' | 'SKILLS' | 'CONTACTS' | 'SEGMENTS' | 'ASSISTANTS' | 'AGENTS' | 'CHATS' | 'INBOX' | 'MEMBERS' | 'SUB_ORGS' | 'BILLING' | 'BROADCASTS' | 'ANALYTICS' | 'AUDIT' | 'PHONE' | 'GMAIL' | 'GOOGLE_SHEETS' | 'GOOGLE_CALENDAR' | 'GOOGLE_DRIVE' | 'GOOGLE_MEET' | 'ONEDRIVE' | 'SHAREPOINT' | 'OUTLOOK_CALENDAR' | 'OUTLOOK' | 'AIRTABLE' | 'NOTION' | 'LINEAR' | 'HUBSPOT' | 'GOHIGHLEVEL' | 'CAL' | 'CALENDLY' | 'RESEND' | 'OAUTH' | 'SLACK' | 'TEAMS' | 'TELEGRAM' | 'TRELLO' | 'FACEBOOK' | 'WHATSAPP' | 'INSTAGRAM' | 'MESSENGER' | 'TIKTOK' | 'JAPIFON' | 'SMPP' | 'TWILIO' | 'TELNYX' | 'ZOHO' | 'ZOHO_BOOKINGS' | 'ZOHO_INVENTORY' | 'ZOHO_CALENDAR' | 'SALESFORCE' | 'STRIPE' | 'SHOPIFY' | 'ZENDESK' | 'MCP' | 'OPENAPI' | 'ODOO' | 'WOOCOMMERCE' required

Connection type

namestring nullable required

Optional name for the connection

external_namestring nullable required

Optional external name for the connection

external_idstring nullable required

Optional external identifier for the connection

status'ACTIVE' | 'INACTIVE' required
status_errorstring nullable required

Optional error message if the connection is in error state

created_atstring date-time nullable required

Timestamp of when the connection was created

updated_atstring date-time nullable required

Timestamp of when the connection was last updated

Example response

{
  "type": "SLACK",
  "name": "My Encompass Connection"
}

Changes

No recorded changes to this operation across all 1 revision of this API.