Skip to content

Update a renewal status

PUT
/api/partners/v1/community/{community_id}/renters/{funnel_renter_id}/units/{funnel_unit_id}/renewal-status/

Update a lease’s renewal status for a given renter and unit

community_id
required
string

The Community ID, this will look like either ‘1234’ or ‘P1234-567’. Alternatively, if you prefix this value with partner-id:, for example partner-id:apts123 you can use your own community, as long as you have previously provided that ID to Funnel.

Examples

Funnel Community ID

The raw integer Funnel ID of a community.

1234
funnel_renter_id
required
string

The client’s funnel id (often referred to as client id or prospect id), this will look like ‘1234’.

Example
12345
funnel_unit_id
required
string

The Funnel unit id.

Example
12345
object
renewal_card_status

Should show the Renewal card

boolean
renewal_body

The text of the renewal body

string
renewal_alert_status

Should show the alert

boolean
renewal_alert_body

The text of the renewal alert body

string
renewal_alert_type

The alert type “WARNING” or “INFO”

string
renewal_allow_clickthrough

Should allow click-through by the resident to the Renewals Widget

boolean
renewal_header

The text of the renewal header

string
renewal_subheader

The text of the renewal header

string
renewal_icon

The icon to show in the renewal card

string
RENEWAL, AUTOPAY, etc. for all icons see https://docs.google.com/document/d/1rY4lMiGGa1IxT_IAzrCBXSpifZ9Fz2LCKAJ2TeLHOR8

Renewal status successfully updated

object
renewal_status_id
integer
7

We were unable to authenticate your request with the provided API key.

object
error_type
string
CommunityNotFound
message
string
Could not find community with corresponding ID.

An active lease could not be matched using the provided community, renter, and unit.

object
error_type
string
LeaseNotFound
message
string
Could not find active lease for client.