Skip to content
All recipes

Renew ADE tokens before they expire

Renew an Automated Device Enrollment (ADE) token through the API so zero-touch enrollment keeps working.

Open in Claude Open in ChatGPT
Product
Endpoint Management
Platforms
Apple devices
Effect
Changes a setting
Agent access
Iru MCP or the Iru API

Before you start

  • An Iru API token with all ADE-related permissions (recipe 1).
  • Access to Apple Business or Apple School Manager to download each new token.
  • If a token expires, Iru can no longer sync devices from Apple Business or Apple School Manager. You can renew at any time.

Prompt for your agent

List my ADE integrations in Iru with GET /api/v1/integrations/apple/ade. For each one, show me its server_name, days_left and whether it uses Blueprint Routing, sorted by days_left. Then stop. When I give you a downloaded .p7m token file and the token it belongs to, show me the renew request and wait for my approval before you send it. Afterward, check that days_left is 364.

Steps

  1. List your ADE tokens

    Have the agent list each token with its server_name and days_left. With Blueprint Routing on, use_blueprint_routing is true and blueprint_id is null.

    GET/api/v1/integrations/apple/ade

    Source: Iru API: List ADE integrations

  2. Download the new token from Apple

    In Apple Business or Apple School Manager, open the Devices tab, then Management Services. Select the service that matches server_name, open the ellipsis (…) menu and select Download Token to get a .p7m file.

    Source: Renew multiple ADE tokens

  3. Renew the token after you approve

    Send the default blueprint_id, phone, email and the token file. With Blueprint Routing, send use_blueprint_routing as true and blueprint_id as null.

    The web app renews only the token shown on its page (Account Menu > Integrations > Apple > Renew Token). Renew any other token through the API.

    POST/api/v1/integrations/apple/ade/{ade_token_id}/renew

    Approval requiredThe agent shows you which token and which .p7m file it's about to send, then waits for your go.

    Source: Renew multiple ADE tokens

  4. Confirm the renewal

    Read the token back and check days_left.

    GET/api/v1/integrations/apple/ade/{ade_token_id}

    Source: Renew multiple ADE tokens

Check it worked

  • days_left is 364 after a successful renewal.

Common pitfalls

  • Don't disconnect an existing token to renew it.
  • Keep track of each downloaded .p7m file and match it to the right token ID.
  • Test on one token before you renew several at once.

FAQ

How do I find ADE tokens that are close to expiring?

GET /api/v1/integrations/apple/ade lists each ADE integration with its server_name and days_left.

What does a renewal request need?

The default blueprint_id, phone, email and the .p7m token file from Apple Business or Apple School Manager. With Blueprint Routing, send use_blueprint_routing as true and blueprint_id as null.

What happens if a token expires?

Device sync from Apple Business or Apple School Manager stops. You can renew at any time, and you don't need to disconnect the integration to renew it.

How do I confirm the renewal worked?

days_left reads 364 after a successful renewal.

Next steps

Sources

Stay up to date

Iru's bi-weekly collection of articles, videos, and research to keep IT & Security teams ahead of the curve.