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

# Set Invoice Reminders

> Turn reminders on or off for an invoice.

## Overview

Turn reminders on or off. They run before the due date and after it, and stop
the moment the invoice is paid, so nobody is chased for money they already
sent.


## OpenAPI

````yaml POST /v1/invoices/{invoiceId}/reminders
openapi: 3.1.0
info:
  title: Reclack API
  version: 1.0.0
  description: >-
    Recurring and one-time stablecoin payments, taken straight from your
    customers' wallets.


    Reclack is non-custodial. Payments move from a customer's wallet to a
    settlement address you control, and Reclack never holds funds and never asks
    anyone for a seed phrase or a private key.


    ## Authentication


    Send your API key in the `Api-Key` header:


    ```

    Api-Key: rk_live_your_key_here

    ```


    `X-API-Key` is accepted too. The key prefix decides the environment:
    `rk_sandbox_` for test chains, `rk_live_` for production.


    ## Responses


    Objects and lists come back under `data`. Errors come back under `error`
    with a `type`, an optional `code` and a message written for a person.
servers:
  - url: https://api.reclack.com
    description: Sandbox and live, chosen by your key
security:
  - apiKeyAuth: []
tags:
  - name: Products
  - name: Prices
  - name: Customers
  - name: Subscriptions
  - name: Usage
  - name: Invoices
  - name: Checkouts
  - name: Payment links
  - name: Transactions
  - name: Webhooks
  - name: API keys
  - name: Settlement
paths:
  /v1/invoices/{invoiceId}/reminders:
    post:
      tags:
        - Invoices
      summary: Set reminders
      description: Turn reminders on or off for an invoice.
      operationId: invoices-reminders
      parameters:
        - name: invoiceId
          in: path
          required: true
          schema:
            type: string
          description: The invoice id.
          example: in_0182
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                enabled:
                  type: boolean
                  description: Whether reminders run for this invoice.
              required:
                - enabled
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                type: object
                properties:
                  data:
                    $ref: '#/components/schemas/Invoice'
        '400':
          description: The request is missing something or contradicts itself
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '401':
          description: No key, a revoked key, or a key that does not exist
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '403':
          description: The key is valid but is not allowed to do this
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
components:
  schemas:
    Invoice:
      type: object
      properties:
        id:
          type: string
          example: in_0182
        code:
          type: string
          description: The human readable number on the document.
          example: INV-00182
        reference:
          type: string
          description: What a payer's link resolves against.
          example: in_0182
        status:
          type: string
          enum:
            - draft
            - open
            - paid
            - overdue
            - void
          example: open
        amount:
          type: string
          example: '120.00'
        amount_atomic:
          type: string
          example: '120000000'
        fee_atomic:
          type: string
          example: '1200000'
        currency:
          type: string
          example: USDC
        network:
          type: string
          example: base
        chain_id:
          type: integer
          example: 8453
        period_start:
          type: string
          format: date-time
          example: '2026-10-18T22:07:41Z'
        period_end:
          type: string
          format: date-time
          example: '2026-10-18T22:07:41Z'
        attempt_count:
          type: integer
          example: 0
        next_attempt_at:
          type: string
          format: date-time
          example: '2026-10-18T22:07:41Z'
        paid_at:
          type: string
          format: date-time
          example: '2026-10-18T22:07:41Z'
        sent_at:
          type: string
          format: date-time
          example: '2026-10-18T22:07:41Z'
        reminders_enabled:
          type: boolean
        last_reminder_at:
          type: string
          format: date-time
          example: '2026-10-18T22:07:41Z'
        failure_code:
          type: string
          example: insufficient_allowance
        failure_message:
          type: string
          example: The authorization no longer covers this amount
        metadata:
          type: object
          additionalProperties: true
        created_at:
          type: string
          format: date-time
          example: '2026-10-18T22:07:41Z'
        updated_at:
          type: string
          format: date-time
          example: '2026-10-18T22:07:41Z'
    Error:
      type: object
      properties:
        error:
          type: object
          properties:
            type:
              type: string
              description: >-
                One of invalid_request_error, authentication_error,
                permission_error or api_error.
              example: invalid_request_error
            code:
              type: string
              description: A stable, machine readable reason.
              example: price_not_found
            message:
              type: string
              description: A sentence written for a person.
              example: No price was found for that id
  securitySchemes:
    apiKeyAuth:
      type: apiKey
      in: header
      name: Api-Key
      description: >-
        Your Reclack API key. The prefix decides the environment: rk_sandbox_
        for test chains, rk_live_ for production.

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.