Salesforce

Get Salesforce Authorization URL

get

Query parameters

company_idintegerRequired

The ID of the company for which the authorization URL is requested

Responses

200

Successfully retrieved the authorization URL.

application/json

get

/salesforce

HTTPcURLJavaScriptPython

GET /salesforce?company_id=1 HTTP/1.1
Host: api.taag.co
Accept: */*

200

Successfully retrieved the authorization URL.

{
  "status": "success",
  "auth_url": "https://example.com/oauth2/authorize"
}

Remove Connected Salesforce Account

delete

Query parameters

company_idintegerRequired

The ID of the company for which the Salesforce account should be removed

Responses

200

Successfully removed the connected Salesforce account.

application/json

delete

/salesforce

HTTPcURLJavaScriptPython

DELETE /salesforce?company_id=1 HTTP/1.1
Host: api.taag.co
Accept: */*

200

Successfully removed the connected Salesforce account.

{
  "status": "success"
}

Get Salesforce Access Token

get

Query parameters

company_idintegerRequired

The ID of the company for which the token is requested

auth_tokenstringRequired

The authorization token received from Salesforce

Responses

200

Successfully retrieved the Salesforce token.

application/json

get

/salesforce/token

HTTPcURLJavaScriptPython

GET /salesforce/token?company_id=1&auth_token=text HTTP/1.1
Host: api.taag.co
Accept: */*

200

Successfully retrieved the Salesforce token.

{
  "status": "success",
  "token": "12345abcde"
}

Get Salesforce Connected Account Status

get

Query parameters

company_idintegerRequired

The ID of the company for which the connected account status is requested

Responses

200

Successfully retrieved the connected account status.

application/json

get

/salesforce/status

HTTPcURLJavaScriptPython

GET /salesforce/status?company_id=1 HTTP/1.1
Host: api.taag.co
Accept: */*

200

Successfully retrieved the connected account status.

{
  "status": "success",
  "token": "12345abcde",
  "auto_sync": true,
  "lead_status": "text"
}

Export Contacts to Salesforce

put

Body

application/json

company_idintegerRequired

The ID of the company

lead_idsinteger[]Optional

Optional list of lead IDs to export

Responses

200

Successfully exported contacts to Salesforce.

application/json

put

/salesforce/contacts

HTTPcURLJavaScriptPython

PUT /salesforce/contacts HTTP/1.1
Host: api.taag.co
Content-Type: application/json
Accept: */*
Content-Length: 31

{
  "company_id": 1,
  "lead_ids": [
    1
  ]
}

200

Successfully exported contacts to Salesforce.

{
  "status": "success"
}

Export Single Contact to Salesforce

put

Body

application/json

company_idintegerRequired

The ID of the company

lead_idintegerRequired

ID of the lead to export

Responses

200

Successfully exported single contact to Salesforce.

application/json

put

/salesforce/single/contact

HTTPcURLJavaScriptPython

PUT /salesforce/single/contact HTTP/1.1
Host: api.taag.co
Content-Type: application/json
Accept: */*
Content-Length: 28

{
  "company_id": 1,
  "lead_id": 1
}

200

Successfully exported single contact to Salesforce.

{
  "status": "success"
}

Update Salesforce Configuration

put

Body

application/json

company_idintegerRequired

The ID of the company

auto_syncbooleanOptional

Whether to enable auto-sync

lead_statusstringOptional

Default lead status to assign

Responses

200

Successfully updated Salesforce configuration.

application/json

put

/salesforce/config

HTTPcURLJavaScriptPython

PUT /salesforce/config HTTP/1.1
Host: api.taag.co
Content-Type: application/json
Accept: */*
Content-Length: 54

{
  "company_id": 1,
  "auto_sync": true,
  "lead_status": "text"
}

200

Successfully updated Salesforce configuration.

{
  "status": "success"
}