Connects two other real numbers. Each one sees the other's real caller ID, not one you pick. This is a genuine three-way call (you, and the two of them), not caller-ID spoofing.
Request
text
POST https://api.spoofey.com/v1/three_way_calls| Field | Required | Notes |
|---|---|---|
agent |
yes | The number to ring first (you, the person setting this up). |
user1 |
yes | The first party's real number. |
user2 |
yes | The second party's real number. Shown to user1 as the caller ID, and vice versa. |
user1 and user2 can't be the same number.
Example
bash
curl https://api.spoofey.com/v1/three_way_calls \
-H "Authorization: Bearer sk_live_..." \
-H "Content-Type: application/json" \
-d '{"agent":"15195551234","user1":"14165557890","user2":"18005551234"}'Response
Returns 200:
json
{
"bridge_id": "3b7e1c2a-...",
"status": "calling",
"agent": "15195551234",
"user1": "14165557890",
"user2": "18005551234",
"minutes_remaining": 40.1,
"business_call": false
}Follow both legs with GET /v1/three_way_calls/:bridge_id.
Errors
Errors come back as {"error":{"message":"...","code":"..."}}. See API errors and rate limits for every status code and the rate limit.