List Forwarding Jobs

POST

https://api.inboxkit.com/v1/api/mailboxes/forwarding/jobs

Maintainer:Not configured

Check the status of your forwarding jobs. You can filter by specific mailbox, status, or action type. Results are paginated and sorted by creation date, newest first.

Request

Authorization

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

Header Params

Body Params application/json

Examples

Responses

🟢200Success Response

application/json

Bodyapplication/json

Request Example

Shell

JavaScript

Java

Swift

curl --location 'https://api.inboxkit.com/v1/api/mailboxes/forwarding/jobs' \
--header 'X-Workspace-Id;' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
    "page": 1,
    "limit": 10,
    "mailbox_uid": "string",
    "status": "pending",
    "action": "enable"
}'

Response Example

{
    "error": false,
    "message": "Forwarding jobs retrieved successfully",
    "jobs": [
        {
            "mailbox_uid": "mb-aaa11111-e89b-12d3-a456-426614174000",
            "mailbox_email": "[email protected]",
            "forwarding_email": "[email protected]",
            "action": "enable",
            "status": "pending",
            "status_message": "Email forwarding enabled: [email protected] -> [email protected]",
            "error_message": "",
            "attempts": 0,
            "max_attempts": 3,
            "created_at": "2025-01-15T10:00:00.000Z",
            "updated_at": "2025-01-15T10:02:30.000Z",
            "completed_at": "2025-01-15T10:02:30.000Z",
            "last_attempt_at": null,
            "next_retry_at": null
        }
    ],
    "pagination": {
        "page": 1,
        "limit": 10,
        "total": 4,
        "pages": 1
    }
}

Modified at 2026-05-21 09:07:23

Remove Email Forwarding

Initiate Consent Request