Create an AR and Task on Prospect

POST

/api/partners/v1/community/{community_id}/renters/{funnel_renter_id}/action-required/

Create an action_required and task in funnel and disable third party vla, if specified in request

Authorizations

• BasicAuth
• BearerAuth

Parameters

Path Parameters

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 Community Syndication ID

The community’s Funnel syndcation ID. An ID in this format is often provided in Funnel feeds to ILS partners.

P1234-567

Partner ID

The ID of the community in the partner system. This needs to have been previously provided to Funnel and setup.

partner-id:apts123

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

Request Body

object

funnel_last_communication_id

string

disable

Disables third party vla handling

boolean

default: true

due_date

Must follow ISO 8601 and include offset

string

default: current date and time

2023-05-16T14:30:00-04:00

task_description

Description to be added to the reminder text for the action_required task

string

Responses

200

Action Required successfully assigned to prospect

object

message

string

Successfully added task

400

401

403

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.

404

A community with this ID does not exist.

object

error_type

string

CommunityNotFound

message

string

Could not find community with corresponding ID.