Build on RentalTide

1// Initiate a call into a rental location
2const call = await fetch(
3  "https://v3.api.rentaltide.com/calls/partner/initiate",
4  {
5    method: "POST",
6    headers: {
7      Authorization: `Bearer ${access_token}`,
8      "Content-Type": "application/json",
9    },
10    body: JSON.stringify({
11      customerId: "cus_4mQp7Yx9",
12      locationId: "loc_8nRj3Kw2",
13      targetType: "location",
14      targetId: "loc_8nRj3Kw2",
15      callerName: "AI Assistant",
16      callerPhone: "+15551234567",
17      callMode: "phone",          // or "walkie_talkie"
18      context: {
19        reason: "booking_followup",
20        bookingId: "bk_2xK9mP4vL7",
21      },
22    }),
23  }
24);
25
26const { call: callData, token, roomName } = await call.json();
27// Connect to the Twilio room with the returned token
28console.log(`Call initiated: ${callData.callId}`);

1// Look up a renter by phone number
2const renters = await fetch(
3  "https://v3.api.rentaltide.com/calls/partner/renters/search?" +
4    new URLSearchParams({ phone: "+15551234567" }),
5  {
6    headers: {
7      Authorization: `Bearer ${access_token}`,
8    },
9  }
10);
11
12const { renters: results } = await renters.json();
13// [{ id, firstName, lastName, email, phoneNumber, ... }]
14
15if (results.length > 0) {
16  // Fetch their active bookings
17  const bookings = await fetch(
18    `https://v3.api.rentaltide.com/calls/partner/renters/${results[0].id}/bookings?status=active`,
19    {
20      headers: {
21        Authorization: `Bearer ${access_token}`,
22      },
23    }
24  );
25
26  const { bookings: activeBookings } = await bookings.json();
27  console.log(`Found ${activeBookings.length} active rentals`);
28}

1// Add a note to a booking during a call
2await fetch(
3  `https://v3.api.rentaltide.com/calls/partner/renters/${renterId}/bookings/${rentalId}/action`,
4  {
5    method: "POST",
6    headers: {
7      Authorization: `Bearer ${access_token}`,
8      "Content-Type": "application/json",
9    },
10    body: JSON.stringify({
11      action: "add_note",
12      data: {
13        content: "Customer called to extend rental by 1 hour. Approved by manager.",
14      },
15    }),
16  }
17);

1// Incoming call webhook payload
2{
3  "event": "call:incoming",
4  "data": {
5    "callId": "call_9vZk2Lm8",
6    "callerName": "AI Phone Assistant",
7    "callerType": "partner_app",
8    "callerPhone": "+15551234567",
9    "callMode": "phone",
10    "status": "ringing",
11    "partnerContext": {
12      "reason": "booking_followup",
13      "bookingId": "bk_2xK9mP4vL7"
14    },
15    "createdAt": "2026-03-09T14:30:00Z"
16  }
17}
18
19// Other events: call:answered, call:rejected,
20//               call:ended, call:missed