> ## Documentation Index > Fetch the complete documentation index at: https://leadping.ai/docs/llms.txt > Use this file to discover all available pages before exploring further. # Create or reactivate a recipient suppression > Creates or reactivates a Leadping suppression entry that blocks future outreach to a recipient across the selected communication channel. ## OpenAPI ````yaml /openapi.json post /suppressions openapi: 3.1.1 info: title: Leadping API description: >- Leadping API for lead intake, messaging, calling, automations, billing, organization settings, and compliant lead communication workflows. license: name: MIT url: https://opensource.org/licenses/MIT version: v1 servers: - url: https://api.leadping.ai description: Production security: [] tags: - name: Analytics - name: Automations - name: Contact - name: Conversations - name: Feedback - name: Leads - name: LeadStatusChanges - name: LeadStatuses - name: Notifications - name: OutboundDelivery - name: Sources - name: Suppressions - name: Tags - name: Users - name: Calls - name: PhoneNumbers - name: Sms - name: Telephony - name: Organizations - name: UserDataExports - name: CallEvents - name: Events - name: SmsEvents - name: PaymentMethods - name: Transactions - name: Usage - name: Wallets paths: /suppressions: post: tags: - Suppressions summary: Create or reactivate a recipient suppression description: >- Creates or reactivates a Leadping suppression entry that blocks future outreach to a recipient across the selected communication channel. operationId: Suppressions_Suppress requestBody: description: The suppression entry request payload for the operation. content: application/json: schema: allOf: - $ref: '#/components/schemas/SuppressionEntryRequest' description: >- Defines a recipient and communication channel to suppress, release, or check before Leadping sends outreach. application/*+json: schema: allOf: - $ref: '#/components/schemas/SuppressionEntryRequest' description: >- Defines a recipient and communication channel to suppress, release, or check before Leadping sends outreach. required: true responses: '201': description: The suppression entry response was created successfully. content: application/json: schema: allOf: - $ref: '#/components/schemas/SuppressionEntryResponse' description: >- Describes a recipient suppression that prevents outreach through one or more communication channels. '400': description: The request was invalid or failed validation. content: application/json: schema: allOf: - $ref: '#/components/schemas/ProblemDetails' description: >- Standard problem-details response containing machine-readable and human-readable information about an HTTP API error. '401': description: Unauthorized content: application/json: schema: allOf: - $ref: '#/components/schemas/ProblemDetails' description: >- Standard problem-details response containing machine-readable and human-readable information about an HTTP API error. components: schemas: SuppressionEntryRequest: type: object properties: organizationId: type: string description: Organization whose suppression list should be used. recipientIdentifier: type: - 'null' - string description: >- Optional provider or customer identifier that uniquely identifies the recipient. phoneNumber: type: - 'null' - string description: >- Recipient phone number to suppress or check, preferably in E.164 format. email: type: - 'null' - string description: Recipient email address to suppress or check. channel: type: string description: >- Communication channel affected by the suppression, such as SMS, voice, email, or all channels. reason: type: - 'null' - string description: Human-readable reason for creating or releasing the suppression. description: >- Defines a recipient and communication channel to suppress, release, or check before Leadping sends outreach. SuppressionEntryResponse: type: object properties: id: type: - 'null' - string description: Unique Leadping identifier for the suppression entry. organizationId: type: - 'null' - string description: Identifier of the organization that owns the suppression entry. recipientIdentifier: type: - 'null' - string description: >- Provider or customer identifier used to recognize the suppressed recipient. normalizedPhoneNumber: type: - 'null' - string description: Suppressed phone number normalized to a consistent format. normalizedEmail: type: - 'null' - string description: Suppressed email address normalized for matching. channel: type: - 'null' - string description: >- Communication channel affected by the suppression, such as SMS, voice, email, or all channels. source: type: - 'null' - string description: System or workflow that created the suppression. status: type: - 'null' - string description: Current lifecycle state, such as active or released. reason: type: - 'null' - string description: >- Human-readable reason the recipient was suppressed or subsequently released. suppressedAt: type: - 'null' - string description: UTC timestamp when the suppression became active. format: date-time releasedAt: type: - 'null' - string description: >- UTC timestamp when the suppression was released, or while it remains active. format: date-time audit: type: array items: allOf: - $ref: '#/components/schemas/SuppressionEntryAudit' description: Records one auditable change to a recipient suppression entry. description: Chronological audit history of suppression and release changes. description: >- Describes a recipient suppression that prevents outreach through one or more communication channels. ProblemDetails: type: object properties: type: type: - 'null' - string description: URI reference that identifies the problem type. title: type: - 'null' - string description: Short, human-readable summary of the problem. status: pattern: ^-?(?:0|[1-9]\d*)$ type: - 'null' - integer - string description: HTTP status code returned for the problem. format: int32 detail: type: - 'null' - string description: >- Human-readable explanation specific to this occurrence of the problem. instance: type: - 'null' - string description: >- URI reference that identifies this specific occurrence of the problem. description: >- Standard problem-details response containing machine-readable and human-readable information about an HTTP API error. SuppressionEntryAudit: type: object properties: id: type: string description: Unique identifier for this suppression audit record. status: type: string description: >- Suppression status established by this change, such as active or released. source: type: string description: System or workflow that initiated the change. timestamp: type: string description: UTC timestamp when the suppression change occurred. format: date-time actorId: type: - 'null' - string description: Identifier of the user or system actor responsible for the change. reason: type: - 'null' - string description: Human-readable reason recorded for the suppression change. safeMetadata: type: object additionalProperties: type: string description: Non-sensitive metadata that provides additional audit context. description: Records one auditable change to a recipient suppression entry. ````