Engagerly 2.0 · One clear workflow for your Discord community
Developer API

Connect Engagerly to your own systems

Read and adjust member balances and add or remove roles from your apps, games and stores — with scoped API keys and a full audit log.

Read the API docs

Premium+Premium and Ultimate can create API keys in the dashboard

REQUESTAdd 500 points to a member when they place an order.

curl -X POST "$API_BASE/v1/open/guilds/$GUILD_ID/points/adjust" \
  -H "X-API-Key: $ENGAGERLY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "user_id": "123456789012345678",
    "type": "add",
    "amount": 500,
    "note": "Order #1042 bonus",
    "ref": "order-1042"
  }'
USE CASES

What teams build with it

  • In-game rewards

    Give points when players hit achievements in your game.

  • Store bonuses

    Reward customers with points or a VIP role when they place an order.

  • Event check-ins

    Grant a role to everyone who attended a live event or webinar.

ENDPOINTS

Four endpoints, scoped by permission.

Every key is limited to the scopes you grant it.

  • GET
    /v1/open/guilds/{guild_id}/points/balance/{user_id}

    Get a member's balance in any of the server's currencies.

    points:read
  • POST
    /v1/open/guilds/{guild_id}/points/adjust

    Add or deduct points for a member, with an optional note and your own reference ID.

    points:write
  • POST
    /v1/open/guilds/{guild_id}/members/{user_id}/roles/{role_id}

    Give a member a Discord role.

    roles:write
  • DELETE
    /v1/open/guilds/{guild_id}/members/{user_id}/roles/{role_id}

    Remove a Discord role from a member.

    roles:write
KEYS & LIMITS

Keys and limits

  • Create API keys in the dashboard on Premium or Ultimate — up to 10 per server.
  • Send the key in the X-API-Key header. Each key only works for its own server.
  • Grant only the scopes a key needs: points:read, points:write or roles:write.
  • Optionally set an expiry date and an IP allowlist for each key.
  • Requests are rate-limited, and every call is recorded in the key's audit log.

Want to see what's coming next for the API?

New endpoints are discussed in the official Discord server first.

Join our official Discord server
READY WHEN YOU ARE

Ready to let participation
run on its own?

Try it as a member