{"command":{"effect":"write","timeoutSeconds":30,"inputSchema":{"type":"object","description":"> \uD83D\uDEA7 > > Profiles not in the specified list will be globally unsubscribed. Always verify profile list membership before calling this endpoint to avoid unintended global unsubscribes.\n\nUnsubscribe one or more profiles from email marketing, SMS marketing, push marketing, or a combination. Learn more about [consent in this guide](https://developers.klaviyo.com/en/docs/collect_email_and_sms_consent_via_api).\n\nPush tokens provided in `subscriptions.push.tokens` will be removed for the specified profiles.\n\nTo remove someone from a list without changing their subscription status, use [Remove Profiles from List](https://developers.klaviyo.com/en/reference/remove_profiles_from_list).\n\nMaximum number of profiles per call: 100<br><br>*Rate limits*:<br>Burst: `75/s`<br>Steady: `750/m`\n\n**Scopes:**\n`lists:write`\n`profiles:write`\n`subscriptions:write`\n\n[OpenAPI Spec](https://raw.githubusercontent.com/klaviyo/openapi/main/openapi/stable/apis/bulk_unsubscribe_profiles.json)","properties":{"headers":{"type":"object","properties":{"revision":{"type":"string","default":"2026-10-15","enum":["2026-10-15"],"description":"API endpoint revision (format: YYYY-MM-DD[.suffix])"}},"required":["revision"],"additionalProperties":false},"body":{"$ref":"#/definitions/SubscriptionDeleteJobCreateQuery"}},"required":["headers","body"],"additionalProperties":false,"definitions":{"SubscriptionDeleteJobCreateQuery":{"type":"object","properties":{"data":{"$ref":"#/definitions/SubscriptionDeleteJobCreateQueryResourceObject"}},"required":["data"]},"SubscriptionDeleteJobCreateQueryResourceObject":{"type":"object","properties":{"type":{"$ref":"#/definitions/ProfileSubscriptionBulkDeleteJobEnum"},"attributes":{"type":"object","properties":{"profiles":{"description":"The profile(s) to unsubscribe","type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/definitions/ProfileSubscriptionDeleteQueryResourceObject"}}},"required":["data"]}},"required":["profiles"]},"relationships":{"type":"object","properties":{"list":{"type":"object","properties":{"data":{"type":"object","properties":{"type":{"$ref":"#/definitions/ListEnum"},"id":{"description":"The list to remove the profiles from","type":"string","examples":["Y6nRLr"]}},"required":["type","id"]}}}}}},"required":["type","attributes"]},"ProfileSubscriptionBulkDeleteJobEnum":{"type":"string","enum":["profile-subscription-bulk-delete-job"]},"ProfileSubscriptionDeleteQueryResourceObject":{"type":"object","properties":{"type":{"$ref":"#/definitions/ProfileEnum"},"id":{"description":"The ID of the profile to unsubscribe.","type":["string","null"],"examples":["01GDDKASAP8TKDDA2GRZDSVP4H"]},"attributes":{"type":"object","properties":{"email":{"description":"The email address to unsubscribe.","type":["string","null"],"examples":["matt-kemp@klaviyo-demo.com"]},"phone_number":{"description":"The phone number to unsubscribe. This must be in E.164 format.","type":["string","null"],"examples":["+15005550006"]},"subscriptions":{"$ref":"#/definitions/UnsubscriptionChannels"}},"required":["subscriptions"]}},"required":["type","attributes"]},"ListEnum":{"type":"string","enum":["list"]},"ProfileEnum":{"type":"string","enum":["profile"]},"UnsubscriptionChannels":{"type":"object","properties":{"email":{"$ref":"#/definitions/EmailUnsubscriptionParameters"},"sms":{"$ref":"#/definitions/SMSUnsubscriptionParameters"},"whatsapp":{"$ref":"#/definitions/WhatsAppUnsubscriptionParameters"},"push":{"$ref":"#/definitions/PushUnsubscriptionParameters"}}},"EmailUnsubscriptionParameters":{"type":"object","properties":{"marketing":{"$ref":"#/definitions/UnsubscriptionParameters"},"open_tracking":{"$ref":"#/definitions/OpenTrackingUnsubscriptionParameters"},"click_tracking":{"$ref":"#/definitions/ClickTrackingUnsubscriptionParameters"}}},"SMSUnsubscriptionParameters":{"type":"object","properties":{"marketing":{"$ref":"#/definitions/UnsubscriptionParameters"},"transactional":{"$ref":"#/definitions/UnsubscriptionParameters"}}},"WhatsAppUnsubscriptionParameters":{"type":"object","properties":{"marketing":{"$ref":"#/definitions/UnsubscriptionParameters"},"transactional":{"$ref":"#/definitions/UnsubscriptionParameters"},"conversational":{"$ref":"#/definitions/UnsubscriptionParameters"}}},"PushUnsubscriptionParameters":{"type":"object","properties":{"marketing":{"$ref":"#/definitions/UnsubscriptionParameters"},"tokens":{"description":"A list of push tokens to unsubscribe/remove.","type":"array","items":{"$ref":"#/definitions/PushTokenEntry"}}},"required":["marketing","tokens"]},"UnsubscriptionParameters":{"type":"object","properties":{"consent":{"description":"The Consent status to be set as part of the unsubscribe call. Currently supports \"UNSUBSCRIBED\".","type":"string","enum":["UNSUBSCRIBED"],"examples":["UNSUBSCRIBED"]}},"required":["consent"]},"OpenTrackingUnsubscriptionParameters":{"type":"object","properties":{"consent":{"description":"The open-tracking consent to revoke. Currently supports \"UNSUBSCRIBED\".","type":"string","enum":["UNSUBSCRIBED"],"examples":["UNSUBSCRIBED"]}},"required":["consent"]},"ClickTrackingUnsubscriptionParameters":{"type":"object","properties":{"consent":{"description":"The click-tracking consent to revoke. Currently supports \"UNSUBSCRIBED\".","type":"string","enum":["UNSUBSCRIBED"],"examples":["UNSUBSCRIBED"]}},"required":["consent"]},"PushTokenEntry":{"type":"object","properties":{"token":{"description":"A push token from APNS or FCM.","type":"string","examples":["1234567890abcdef"]},"platform":{"description":"The platform on which the push token was created. Either \"ios\" or \"android\".","type":"string","enum":["android","ios"]},"vendor":{"description":"The vendor of the push token. Either \"apns\" or \"fcm\".","type":"string","enum":["apns","fcm"],"examples":["apns"]},"enablement_status":{"description":"The enablement status for the push token.","type":["string","null"],"enum":["AUTHORIZED","DENIED","NOT_DETERMINED","PROVISIONAL","UNAUTHORIZED"],"examples":["AUTHORIZED"]},"background":{"description":"The background state of the push token.","type":["string","null"],"enum":["AVAILABLE","DENIED","RESTRICTED"],"examples":["AVAILABLE"]},"device_metadata":{"$ref":"#/definitions/PushTokenDeviceMetadata"}},"required":["token","platform","vendor"]},"PushTokenDeviceMetadata":{"type":"object","properties":{"device_id":{"description":"Relatively stable ID for the device. Will update on app uninstall and reinstall","type":["string","null"],"examples":["1234567890"]},"klaviyo_sdk":{"description":"The name of the SDK used to create the push token.","type":["string","null"],"enum":["android","flutter","flutter_community","react_native","swift"],"examples":["swift"]},"sdk_version":{"description":"The version of the SDK used to create the push token","type":["string","null"],"examples":["1.0.0"]},"device_model":{"description":"The model of the device","type":["string","null"],"examples":["iPhone12,1"]},"os_name":{"description":"The name of the operating system on the device.","type":["string","null"],"enum":["android","ios","ipados","macos","tvos"],"examples":["ios"]},"os_version":{"description":"The version of the operating system on the device","type":["string","null"],"examples":["14.0"]},"manufacturer":{"description":"The manufacturer of the device","type":["string","null"],"examples":["Apple"]},"app_name":{"description":"The name of the app that created the push token","type":["string","null"],"examples":["Klaviyo"]},"app_version":{"description":"The version of the app that created the push token","type":["string","null"],"examples":["1.0.0"]},"app_build":{"description":"The build of the app that created the push token","type":["string","null"],"examples":["1"]},"app_id":{"description":"The ID of the app that created the push token","type":["string","null"],"examples":["com.klaviyo.app"]},"environment":{"description":"The environment in which the push token was created","type":["string","null"],"enum":["debug","release"],"examples":["release"]}}}}},"name":"Bulk Unsubscribe Profiles","id":"klaviyo.bulk_unsubscribe_profiles","example":{"headers":{"revision":"2026-10-15"},"body":{"data":{"type":"profile-subscription-bulk-delete-job","attributes":{"profiles":{"data":[]}}}}},"maxRequests":1,"summary":false}}