Create a new directory matchmaking request

Create a matchmaking request in one of your own directories from your own server. Authenticate with your API token (Authorization: Token <your-api-token>); the token’s organization must own the directory. 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.

Before submitting, read the directory’s matchmaking request form (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.

A company website without a scheme (acme.com) is stored with https://. One that is not an http(s) web address (for example an email address) is dropped, with its answer cleared, and the request is still created without it instead of answering 400.

The directory must have matchmaking requests enabled. Limited to 50 requests per hour per user.