GuidesAPI ReferenceZapier API
Transfers

Update Transfer

Update an existing transfer rule. Only transfers belonging to the organization associated with the API key can be updated.

PUT
/v1/transfers/{transferId}

Authorization

bearerAuth
AuthorizationBearer <token>

Bearer token authentication for API access.

In: header

Path Parameters

transferId?number

The unique identifier of the transfer

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

curl -X PUT "https://api.sophiie.ai/v1/transfers/{transferId}" \  -H "Content-Type: application/json" \  -d '{}'
{
  "transfer": {
    "id": 7,
    "label": "Sales Department Transfer",
    "name": "Sales Team",
    "method": "WARM",
    "destinationType": "DEPARTMENT",
    "destination": "dep_sales_01",
    "conditions": "When the customer asks to speak with a sales representative.",
    "summaryFormat": "Customer {name} is calling about {topic}. Key details: {summary}.",
    "settings": {
      "ignore_business_hours": false
    },
    "isEnabled": true,
    "scenarioId": null,
    "createdAt": "2026-01-15T10:30:00.000Z",
    "updatedAt": "2026-01-20T14:00:00.000Z"
  }
}
{
  "success": false,
  "message": "Bad request",
  "error": {
    "status": 400,
    "message": "Bad request"
  }
}
{
  "success": false,
  "message": "Invalid or expired token",
  "error": {
    "status": 401,
    "message": "Invalid or expired token"
  }
}
{
  "success": false,
  "message": "Not found",
  "error": {
    "status": 404,
    "message": "Not found"
  }
}
{
  "success": false,
  "message": "Conflict",
  "error": {
    "status": 409,
    "message": "Conflict"
  }
}
{
  "success": false,
  "message": "Internal server error",
  "error": {
    "status": 500,
    "message": "Internal server error"
  }
}

List Transfers GET

Retrieve a paginated list of transfer rules. Returns transfer data including label, method, destination, conditions, and settings. Results are filtered by the organization associated with the API key.

Contact Developer Support

Stuck? Do you need help? Contact our developer support team