> ## Documentation Index > Fetch the complete documentation index at: https://docs.paubox.com/llms.txt > Use this file to discover all available pages before exploring further. # Subscribe subscribers > Re-subscribes one or more subscribers, identified by their UUIDs. When `subscription_list_ids` is supplied, the matching subscriptions have their `unsubscribed_at` cleared. When it is omitted, only the global opt-out (`opted_out_on`) is cleared and list-level opt-outs are left untouched. In both cases the global opt-out is cleared, because a subscriber who is subscribed to any list is by definition not globally unsubscribed. **Example curl command:** ```bash curl -X POST \ https://api.paubox.com/v1/marketing/subscriptions/subscribe \ -H 'authorization: Token token=YOUR_API_KEY' \ -H 'content-type: application/json' \ -d '{ "subscriber_ids": ["8f14e45f-ceea-467a-9f2c-4b3d2a1e5c60"], "subscription_list_ids": ["123e4567-e89b-12d3-a456-426614174000"] }' ``` ## OpenAPI ````yaml openapi2 POST /subscriptions/subscribe openapi: 3.0.3 info: title: Paubox Marketing API description: > Public documentation Paubox Marketing API. All Paubox Marketing customers have access to the Paubox Marketing API to automate various tasks. ## Authentication Use the authorization header in requests with the format: `authorization: Token token=` Replace `` with your API key. Find your API key in the address bar from the email builder (note: each API Key is displayed only once upon creation). ## Base URL `https://api.paubox.com/v1/marketing` contact: name: Paubox Support url: https://www.paubox.com version: 1.0.0 servers: - url: https://api.paubox.com/v1/marketing description: Production server security: - TokenAuth: [] tags: - name: subscribers description: Subscriber management operations - name: analytics description: Campaign analytics and reporting operations - name: campaign_mailings description: Campaign mailing management and sending operations - name: drip_campaigns description: Drip campaign management and automation operations - name: subscription_lists description: Subscription list management operations - name: subscriptions description: Subscriber opt-in and opt-out operations - name: tracking_links description: Tracking link analytics and data operations paths: /subscriptions/subscribe: post: tags: - subscriptions summary: Subscribe subscribers description: > Re-subscribes one or more subscribers, identified by their UUIDs. When `subscription_list_ids` is supplied, the matching subscriptions have their `unsubscribed_at` cleared. When it is omitted, only the global opt-out (`opted_out_on`) is cleared and list-level opt-outs are left untouched. In both cases the global opt-out is cleared, because a subscriber who is subscribed to any list is by definition not globally unsubscribed. **Example curl command:** ```bash curl -X POST \ https://api.paubox.com/v1/marketing/subscriptions/subscribe \ -H 'authorization: Token token=YOUR_API_KEY' \ -H 'content-type: application/json' \ -d '{ "subscriber_ids": ["8f14e45f-ceea-467a-9f2c-4b3d2a1e5c60"], "subscription_list_ids": ["123e4567-e89b-12d3-a456-426614174000"] }' ``` operationId: subscribeSubscribers requestBody: content: application/json: schema: $ref: '#/components/schemas/SubscriptionChangeRequest' example: subscriber_ids: - 8f14e45f-ceea-467a-9f2c-4b3d2a1e5c60 subscription_list_ids: - 123e4567-e89b-12d3-a456-426614174000 required: true responses: '200': description: >- The affected subscribers. If the operation raises, the response is still `200` but the body contains an `errors` string. content: application/json: schema: $ref: '#/components/schemas/SubscriptionChangeResponse' '401': $ref: '#/components/responses/Unauthorized' '500': $ref: '#/components/responses/InternalServerError' components: schemas: SubscriptionChangeRequest: required: - subscriber_ids type: object properties: subscriber_ids: type: array description: UUIDs of the subscribers to update items: type: string subscription_list_ids: type: array description: >- UUIDs of the subscription lists to update the subscribers on. Omit to act on the subscribers' global opt-out instead. items: type: string SubscriptionChangeResponse: type: object description: >- The affected subscribers in JSON:API form. Returned with HTTP 200; on failure the body carries `errors` instead of `data`. properties: data: type: array items: $ref: '#/components/schemas/DetailedSubscriber' errors: type: string description: Error message, present only when the operation failed DetailedSubscriber: type: object properties: id: type: string description: Unique identifier for the subscriber type: type: string description: Resource type attributes: $ref: '#/components/schemas/DetailedSubscriber_attributes' Error: type: object properties: error: type: string description: Error message code: type: string description: Error code details: type: object description: Additional error details DetailedSubscriber_attributes: type: object properties: email: type: string description: Subscriber's email address format: email first_name: type: string description: Subscriber's first name last_name: type: string description: Subscriber's last name unsubscribed: type: boolean description: Whether the subscriber is unsubscribed created_at: type: string description: Timestamp when subscriber was created format: date-time updated_at: type: string description: Timestamp when subscriber was last updated format: date-time custom_fields: type: array items: $ref: '#/components/schemas/DetailedSubscriber_attributes_custom_fields' subscription_lists: type: array items: $ref: >- #/components/schemas/DetailedSubscriber_attributes_subscription_lists statistics: $ref: '#/components/schemas/DetailedSubscriber_attributes_statistics' DetailedSubscriber_attributes_custom_fields: type: object properties: subscriber_custom_field_type_id: type: string description: ID of the custom field type custom_field_name: type: string description: Name of the custom field custom_field_value: type: string description: Value of the custom field DetailedSubscriber_attributes_subscription_lists: type: object properties: id: type: string description: Subscription list ID name: type: string description: Subscription list name unsubscribed: type: boolean description: Whether subscriber is unsubscribed from this list DetailedSubscriber_attributes_statistics: type: object properties: deliveries: type: integer description: Number of deliveries delivered: type: integer description: Number of delivered emails opened: type: integer description: Number of opened emails clicked: type: integer description: Number of clicked emails soft_bounced: type: integer description: Number of soft bounces hard_bounced: type: integer description: Number of hard bounces unsubscribed: type: integer description: Number of unsubscribes global_unsubscribed: type: integer description: Number of global unsubscribes responses: Unauthorized: description: Unauthorized content: application/json: schema: $ref: '#/components/schemas/Error' InternalServerError: description: Internal server error content: application/json: schema: $ref: '#/components/schemas/Error' securitySchemes: TokenAuth: type: apiKey description: >- Token-based authentication. Use format: "Token token=" where is your API key name: authorization in: header ````