# Procedures

Submit human-collected input to Fin Procedures via the HITL (Human in the Loop) API.

 

When a Fin Procedure reaches a HITL step with the API channel enabled, Intercom sends a `procedure.hitl_notification.created` webhook to your system. Your system collects the required input and responds via the callback endpoint documented here.

 

{% admonition type="warning" %}
This API requires the Procedures HITL API feature to be enabled for your workspace and an OAuth token with the `write_conversations` scope.
{% /admonition %}


## Submit human input to a Fin Procedure HITL step

 - [POST /procedures/{conversation_id}/collect_agent_input](https://developers.intercom.com/docs/references/preview/rest-api/api.intercom.io/procedures/collectprocedureagentinput.md): Submit human-collected input to a Fin Procedure that is paused at a Human in the Loop (HITL) step.

When a procedure reaches a HITL step with the API channel enabled, Intercom sends a procedure.hitl_notification.created webhook. Use the callback_url from that webhook payload to call this endpoint with the collected attribute values.

The step_id must match the one from the webhook payload, and attribute_values must include a value for every attribute listed in attributes_to_collect.

{% admonition type="info" name="Authentication" %}
This endpoint requires an OAuth token with the write_conversations scope. The admin associated with the token must have access to the conversation.
{% /admonition %}

{% admonition type="warning" name="Feature access" %}
This endpoint requires the Procedures HITL API feature to be enabled for your workspace.
{% /admonition %}