Find MCP Enrollment
curl --request POST \
--url https://gateway.firsttouch.ai/api/public/tools/find_mcp_enrollment \
--header 'Content-Type: application/json' \
--header 'X-API-Key: <api-key>' \
--data '
{
"enrollmentId": null,
"prospectId": null,
"linkedInUrl": null,
"email": null,
"phone": null,
"hubspotContactId": null,
"firstName": null,
"lastName": null,
"companyDomain": null
}
'import requests
url = "https://gateway.firsttouch.ai/api/public/tools/find_mcp_enrollment"
payload = {
"enrollmentId": None,
"prospectId": None,
"linkedInUrl": None,
"email": None,
"phone": None,
"hubspotContactId": None,
"firstName": None,
"lastName": None,
"companyDomain": None
}
headers = {
"X-API-Key": "<api-key>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {'X-API-Key': '<api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({
enrollmentId: null,
prospectId: null,
linkedInUrl: null,
email: null,
phone: null,
hubspotContactId: null,
firstName: null,
lastName: null,
companyDomain: null
})
};
fetch('https://gateway.firsttouch.ai/api/public/tools/find_mcp_enrollment', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://gateway.firsttouch.ai/api/public/tools/find_mcp_enrollment",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'enrollmentId' => null,
'prospectId' => null,
'linkedInUrl' => null,
'email' => null,
'phone' => null,
'hubspotContactId' => null,
'firstName' => null,
'lastName' => null,
'companyDomain' => null
]),
CURLOPT_HTTPHEADER => [
"Content-Type: application/json",
"X-API-Key: <api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://gateway.firsttouch.ai/api/public/tools/find_mcp_enrollment"
payload := strings.NewReader("{\n \"enrollmentId\": null,\n \"prospectId\": null,\n \"linkedInUrl\": null,\n \"email\": null,\n \"phone\": null,\n \"hubspotContactId\": null,\n \"firstName\": null,\n \"lastName\": null,\n \"companyDomain\": null\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("X-API-Key", "<api-key>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://gateway.firsttouch.ai/api/public/tools/find_mcp_enrollment")
.header("X-API-Key", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"enrollmentId\": null,\n \"prospectId\": null,\n \"linkedInUrl\": null,\n \"email\": null,\n \"phone\": null,\n \"hubspotContactId\": null,\n \"firstName\": null,\n \"lastName\": null,\n \"companyDomain\": null\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://gateway.firsttouch.ai/api/public/tools/find_mcp_enrollment")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["X-API-Key"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"enrollmentId\": null,\n \"prospectId\": null,\n \"linkedInUrl\": null,\n \"email\": null,\n \"phone\": null,\n \"hubspotContactId\": null,\n \"firstName\": null,\n \"lastName\": null,\n \"companyDomain\": null\n}"
response = http.request(request)
puts response.read_body{
"error": "<string>",
"message": "<string>",
"traceId": "<string>",
"details": {
"currentStatus": "pending"
}
}{
"error": "<string>",
"message": "<string>",
"traceId": "<string>",
"details": {
"currentStatus": "pending"
}
}{
"error": "<string>",
"message": "<string>",
"traceId": "<string>",
"details": {
"currentStatus": "pending"
}
}{
"error": "<string>",
"message": "<string>",
"traceId": "<string>",
"details": {
"currentStatus": "pending"
}
}{
"error": "<string>",
"message": "<string>",
"traceId": "<string>",
"details": {
"currentStatus": "pending"
}
}{
"error": "<string>",
"message": "<string>",
"traceId": "<string>",
"details": {
"currentStatus": "pending"
}
}{
"error": "<string>",
"message": "<string>",
"traceId": "<string>",
"details": {
"currentStatus": "pending"
}
}{
"error": "<string>",
"message": "<string>",
"traceId": "<string>",
"details": {
"currentStatus": "pending"
}
}Dynamic Actions
Find MCP Enrollment
Requires dynamic_actions:write.
Detailed usage guidance
- Members receive only their own enrollments.
- Call get_guide with topic=dynamic_actions for the complete one-contact workflow.
- Find existing MCP Dynamic Actions enrollments for one contact, including completed or canceled history, so the MCP client can resolve whether the requested action continues the current conversational sequence or starts fresh outreach.
- If no candidate is returned and the requested action has all required identity and target data, create the new action without asking the customer to confirm the same request again.
- When candidates are returned, reuse the exact enrollmentId for a related step in an enrollment created or selected earlier in the conversation, even if its status is completed.
- Use create_contact_sequence for clearly new, fresh, separate, or unrelated outreach.
- Historical matches alone must not force a confirmation question.
- Ask only when multiple enrollments plausibly overlap, an existing current sequence may conflict with apparently fresh outreach, or the intended sequence or branch is unclear.
- Do not use status alone as the intent boundary: in-progress and completed enrollments can be extended, while pending, failed, and canceled enrollments cannot.
- Search by enrollmentId, prospectId, email, LinkedIn URL, phone, HubSpot contact id, or name with optional companyDomain.
- This searches MCP Dynamic Actions enrollments across dynamic action flow plans;
candidates include sourceDescription when known, flowPlanId, raw runtime status, hasFailedAction, flowPlanDisplayStatus, and a lightweight root with nodeId, type, payload.subject, payload.subjectType, next, onConnectionAccepted, and onConnectionTimeout. - Use sourceDescription and root as context for sequence and branch selection.
- Use root to choose an email reply or new thread on the requested branch.
- Use get_flow_enrollment after selecting an enrollment only when complete enrollment/action/task details are needed.
POST
/
api
/
public
/
tools
/
find_mcp_enrollment
Find MCP Enrollment
curl --request POST \
--url https://gateway.firsttouch.ai/api/public/tools/find_mcp_enrollment \
--header 'Content-Type: application/json' \
--header 'X-API-Key: <api-key>' \
--data '
{
"enrollmentId": null,
"prospectId": null,
"linkedInUrl": null,
"email": null,
"phone": null,
"hubspotContactId": null,
"firstName": null,
"lastName": null,
"companyDomain": null
}
'import requests
url = "https://gateway.firsttouch.ai/api/public/tools/find_mcp_enrollment"
payload = {
"enrollmentId": None,
"prospectId": None,
"linkedInUrl": None,
"email": None,
"phone": None,
"hubspotContactId": None,
"firstName": None,
"lastName": None,
"companyDomain": None
}
headers = {
"X-API-Key": "<api-key>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {'X-API-Key': '<api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({
enrollmentId: null,
prospectId: null,
linkedInUrl: null,
email: null,
phone: null,
hubspotContactId: null,
firstName: null,
lastName: null,
companyDomain: null
})
};
fetch('https://gateway.firsttouch.ai/api/public/tools/find_mcp_enrollment', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://gateway.firsttouch.ai/api/public/tools/find_mcp_enrollment",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'enrollmentId' => null,
'prospectId' => null,
'linkedInUrl' => null,
'email' => null,
'phone' => null,
'hubspotContactId' => null,
'firstName' => null,
'lastName' => null,
'companyDomain' => null
]),
CURLOPT_HTTPHEADER => [
"Content-Type: application/json",
"X-API-Key: <api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://gateway.firsttouch.ai/api/public/tools/find_mcp_enrollment"
payload := strings.NewReader("{\n \"enrollmentId\": null,\n \"prospectId\": null,\n \"linkedInUrl\": null,\n \"email\": null,\n \"phone\": null,\n \"hubspotContactId\": null,\n \"firstName\": null,\n \"lastName\": null,\n \"companyDomain\": null\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("X-API-Key", "<api-key>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://gateway.firsttouch.ai/api/public/tools/find_mcp_enrollment")
.header("X-API-Key", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"enrollmentId\": null,\n \"prospectId\": null,\n \"linkedInUrl\": null,\n \"email\": null,\n \"phone\": null,\n \"hubspotContactId\": null,\n \"firstName\": null,\n \"lastName\": null,\n \"companyDomain\": null\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://gateway.firsttouch.ai/api/public/tools/find_mcp_enrollment")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["X-API-Key"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"enrollmentId\": null,\n \"prospectId\": null,\n \"linkedInUrl\": null,\n \"email\": null,\n \"phone\": null,\n \"hubspotContactId\": null,\n \"firstName\": null,\n \"lastName\": null,\n \"companyDomain\": null\n}"
response = http.request(request)
puts response.read_body{
"error": "<string>",
"message": "<string>",
"traceId": "<string>",
"details": {
"currentStatus": "pending"
}
}{
"error": "<string>",
"message": "<string>",
"traceId": "<string>",
"details": {
"currentStatus": "pending"
}
}{
"error": "<string>",
"message": "<string>",
"traceId": "<string>",
"details": {
"currentStatus": "pending"
}
}{
"error": "<string>",
"message": "<string>",
"traceId": "<string>",
"details": {
"currentStatus": "pending"
}
}{
"error": "<string>",
"message": "<string>",
"traceId": "<string>",
"details": {
"currentStatus": "pending"
}
}{
"error": "<string>",
"message": "<string>",
"traceId": "<string>",
"details": {
"currentStatus": "pending"
}
}{
"error": "<string>",
"message": "<string>",
"traceId": "<string>",
"details": {
"currentStatus": "pending"
}
}{
"error": "<string>",
"message": "<string>",
"traceId": "<string>",
"details": {
"currentStatus": "pending"
}
}Body
application/json
Response
Tool result.