> ## Documentation Index
> Fetch the complete documentation index at: https://apidocs.hopnow.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Submit Agreement Actions

> Accept or reject one or more pending assigned agreements

Accepts or rejects one or more pending assigned agreements. The signer must be an associated person on the account flagged as an authorized signer (`is_signer`). The API does not perform email, phone, or OTP verification before recording the action. An agreement can only be responded to once.

## Path Parameters

<ParamField path="customer_id" type="string" required>
  Identifier of the Platform customer (`cus_…`).
</ParamField>

<ParamField path="account_id" type="string" required>
  Identifier of the Platform end-customer account (`acct_…`).
</ParamField>

## Request Body

<ParamField body="signer_id" type="string" required>
  Associated person id (`aap_…`) for the authorized signer submitting the action. Must be flagged `is_signer` on the account.
</ParamField>

<ParamField body="agreement_actions" type="object[]" required>
  One to 50 agreement actions. Duplicate `agreement_id` values are rejected.

  <Expandable title="child attributes">
    <ParamField body="agreement_id" type="string" required>
      Assigned agreement id (`aagr_…`).
    </ParamField>

    <ParamField body="action" type="enum" required>
      One of `accept` or `reject`.
    </ParamField>
  </Expandable>
</ParamField>

## Response

Returns 200 with an agreement action result.

<ResponseField name="results" type="object[]">
  One result per submitted agreement action.

  <Expandable title="result attributes">
    <ResponseField name="agreement_id" type="string">
      Assigned agreement id (`aagr_…`).
    </ResponseField>

    <ResponseField name="status" type="enum">
      Resulting agreement status, e.g. `accepted` or `rejected`.
    </ResponseField>

    <ResponseField name="responded_at" type="string">
      ISO 8601 timestamp when the action was recorded.
    </ResponseField>
  </Expandable>
</ResponseField>

<RequestExample>
  ```json Request theme={null}
  {
    "signer_id": "aap_8e5r3t6y0u2i4k9m4p7q1w",
    "agreement_actions": [
      {
        "agreement_id": "aagr_2k9m4p7q1w8e5r3t6y0u2i4",
        "action": "accept"
      }
    ]
  }
  ```
</RequestExample>

<ResponseExample>
  ```json Response theme={null}
  {
    "results": [
      {
        "agreement_id": "aagr_2k9m4p7q1w8e5r3t6y0u2i4",
        "status": "accepted",
        "responded_at": "2026-06-22T09:12:45Z"
      }
    ]
  }
  ```
</ResponseExample>