Create a new directory matchmaking request
POST
https://v1.api.partnerpage.io/api/directory/private/v1alpha/directories/{directoryId}/matchmaking/
Authorization: Token <your-api-token>). CAPTCHA is not required: the token is the trust signal. The matchmaking form on the public directory website is a separate flow for anonymous visitors; it requires a valid captcha and an API token does not replace it there.GET /api/directory/public/v1alpha/directories/{directoryId}/forms/matchmaking-request/) for the field IDs, internal labels, types and which fields are required. Send one answer per field in form.answers, identified by fieldId or internalLabel. First name, last name, email and company name are always required; the directory's form can require more. Property names are accepted in camelCase (as in the examples) or snake_case (as in the schema). utmQueryParams stores attribution data with the request.Request
Path Params
Body Params Required
application/json
Responses
Request Request Example
Shell
JavaScript
Java
Swift
cURL
curl --location 'https://v1.api.partnerpage.io/api/directory/private/v1alpha/directories//matchmaking/' \
--header 'Authorization: <api-key>' \
--header 'Content-Type: application/json' \
--data-raw '{
"form": {
"answers": [
{
"fieldId": "0165c5e6-e562-4ad9-adce-efc9844a95fc",
"answer": "John"
},
{
"internalLabel": "partnerpage-last_name",
"answer": "Doe"
},
{
"internalLabel": "partnerpage-email",
"answer": "john.doe@mycompany.io"
},
{
"internalLabel": "partnerpage-company_name",
"answer": "MyCompany"
}
]
},
"utmQueryParams": {
"utmSource": "api",
"utmMedium": "server-to-server"
}
}'Response Response Example
{
"id": "219a7d94-b934-4ccf-880f-d24b55e7e03e",
"created": "2024-08-23T13:40:00+00:00",
"answers": [],
"utmQueryParams": {},
"owner": null
}Modified at 2026-10-20 14:27:55