Skip to main content
POST
/
api
/
v1
/
campaigns
/
{campaign_id}
/
sftp
/
test-connection
curl -X POST "https://app.talkover.ai/api/v1/campaigns/campaign-uuid/sftp/test-connection" \
  -H "Authorization: Bearer talq_your_environment_token_here"

{
  "success": true,
  "message": "SFTP connection successful",
  "data": {
    "tested_at": "2024-01-15T16:45:00Z",
    "import_path_accessible": true,
    "export_path_accessible": true
  }
}

​
Test Campaign SFTP Connection

Run a connectivity check against the configured SFTP server. The result is stored on the SFTP config (last_test_at, last_test_success) and required before the integration can be enabled.

​
Endpoint

POST /api/v1/campaigns/{campaign_id}/sftp/test-connection

​
Path parameters

​
campaign_id
string
required
Campaign UUID.

​
Request headers

​
Authorization
string
required
Bearer token. Format: Bearer talq_your_environment_token_here

​
Examples

curl -X POST "https://app.talkover.ai/api/v1/campaigns/campaign-uuid/sftp/test-connection" \
  -H "Authorization: Bearer talq_your_environment_token_here"

​
Response

​
Success

{
  "success": true,
  "message": "SFTP connection successful",
  "data": {
    "tested_at": "2024-01-15T16:45:00Z",
    "import_path_accessible": true,
    "export_path_accessible": true
  }
}

​
Failure

{
  "success": false,
  "message": "SFTP connection failed",
  "data": {
    "tested_at": "2024-01-15T16:45:00Z",
    "error": "Authentication failed"
  }
}