Close a contact request

POST

https://v1.api.partnerpage.io/api/directory/private/v1alpha/contact-requests/{contactId}/close/

Directory owner closes a pending contact request. Only pending requests can be closed; a closed request cannot be accepted, declined or reopened, and no email is sent to the partner or the customer. Request body uses snake_case: close_reason (required) is one of partner_unresponsive, spam, duplicate, customer_withdrew, or other. When close_reason is other, close_reason_detail (max 500 chars) is required and must be non-empty; for any other close_reason, close_reason_detail must be omitted or empty. Close fields are returned on contact request list and detail responses.

Request

Authorization

API Key

Add parameter in header

Authorization

Example:

Authorization: ********************

Path Params

Body Params

application/json

Required

Examples

Responses

🟢200

application/json

Bodyapplication/json

🟠400

🟠403

🟠404

Request Example

Shell

JavaScript

Java

Swift

curl --location 'https://v1.api.partnerpage.io/api/directory/private/v1alpha/contact-requests//close/' \
--header 'Authorization: <api-key>' \
--header 'Content-Type: application/json' \
--data '{
    "close_reason": "partner_unresponsive",
    "close_reason_detail": "string"
}'

Response Example

{
    "first_name": "string",
    "last_name": "string",
    "email": "user@example.com",
    "phone": "string",
    "company_name": "string",
    "company_website": "string",
    "comments": "string",
    "utm_query_params": null,
    "href": "string",
    "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
    "created": "string",
    "state": "string",
    "project_status": "new",
    "entry": {
        "property1": "string",
        "property2": "string"
    },
    "directory": {
        "property1": "string",
        "property2": "string"
    },
    "source": "matchmaking",
    "custom_form_response_id": "eb48d096-4b1f-4212-a99d-f06a387dc0a3",
    "decline_reason": "string",
    "decline_reason_detail": "string",
    "close_reason": "string",
    "close_reason_detail": "string",
    "routing_source": "string",
    "match_origin": "751c83d6-a816-460d-aa70-93ce53a14bdc",
    "custom_form": "string",
    "events": [
        {
            "type": "note",
            "timestamp": "2019-08-24T14:15:22.123Z",
            "data": {
                "property1": "string",
                "property2": "string"
            }
        }
    ],
    "reminder": {
        "available_type": "reminder",
        "last_sent": {
            "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
            "type": "reminder",
            "message": "string",
            "created": "2019-08-24T14:15:22.123Z",
            "sender": {
                "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
                "full_name": "string",
                "email": "user@example.com",
                "role": "directory_owner"
            }
        },
        "partner_has_recipients": true
    },
    "first_viewed_at": "2019-08-24T14:15:22.123Z"
}

Modified at 2026-10-05 17:28:20

reviewsDirectoryExportRetrieve

Send a reminder to the partner about a contact request