User Lifecycle Scheduling

Automatically send verification reminders and manage user accounts based on verification status.

How It Works

Note: Schedules are part of the user account structure. Each user account (UserAccount) contains a schedules field that stores all planned or executed scheduled tasks for that user. This includes verification reminders, status changes, and deletion schedules. See Account Structure for details on the complete user account model.

cidaas supports two types of schedules:

Schedule Type	When Created	Applies To	Use Case
Auto Schedules	Automatically during registration	All new users	Standard verification reminders, automatic deactivation/deletion
Manual Schedules	Via API call	Specific users	Custom lifecycle management for individual users

Auto Schedules

• Created automatically when users register
• Use global schedule setups configured in Admin Portal
• Apply to all new users
• No API calls needed

Manual Schedules

• Created via API for specific users
• Independent of global setups
• Custom timing and actions per user
• Requires API access with proper scopes

Configure Auto Schedules (Global Setup)

Auto schedules are configured once in the Admin Portal and automatically apply to all new users.

Setup Steps:

1. Go to Settings > User schedules in Admin Portal
2. Configure schedule parameters (see table below)
3. Click Save

Schedule Configuration Options

Option	Description	Rules
Reminders	Send up to 5 verification reminders	Must be sequential (1, 2, 3...). Each reminder must be scheduled later than the previous one. Delete in reverse order (5, 4, 3...).
Status Change	Automatically change user status (e.g., DECLINED)	Time must be after all reminders are sent
Deletion	Automatically delete user account	Time must be after all reminders and status changes
Periodic Tasks	Recurring schedules	Minimum 24 hours (86400 seconds). Repeats until canceled

Example: Reminder 1 at 5 minutes, Reminder 2 at 60 minutes, Status change at 7 days, Deletion at 30 days.

Create Manual Schedules

Create custom schedules for specific users via API when you need different timing or actions than the global setup.

When to use:

• User needs different reminder timing
• Custom status change schedule for specific user
• One-off deletion schedule
• User-specific lifecycle management

API: POST /user-scheduling-srv/user/schedules with scheduleSpecificSchedulesOnly: true

Technical Integration

Schedule Setups (Global Configurations)

API	Description	Link
Get all schedule setups	Retrieve the list of all configured schedule setups	API Documentation
Get schedule setup by ID	Retrieve a specific schedule setup configuration	API Documentation
Create or update schedule setup	Create a new schedule setup or update an existing one	API Documentation
Delete schedule setup	Delete a configured schedule setup	API Documentation

User Schedule Management

API	Description	Link
Create user schedules	Create scheduled tasks for a specific user (Auto-User or User Related)	API Documentation
Postpone user schedule	Update the execution time of an existing scheduled task	API Documentation
Cancel user schedule	Cancel and remove a scheduled task	API Documentation

Examples

Scenario	Type	Configuration
Email verification reminder	Auto	Condition: COMMUNICATION_VERIFICATION_MEDIUM Action: REMIND_VERIFICATION Time: 24 hours (86400 seconds) Reminder: 1
Auto-deactivate unverified accounts	Auto	Condition: COMMUNICATION_VERIFICATION_MEDIUM Action: CHANGE_USERSTATUS Time: 7 days (604800 seconds) Status: DECLINED
Custom schedule for specific user	Manual	API: POST /user-scheduling-srv/user/schedules scheduleSpecificSchedulesOnly: true Custom timing/actions

Actions & Conditions

Action	Description
REMIND_VERIFICATION	Send verification reminder email
CHANGE_USERSTATUS	Change user status (VERIFIED, UNVERIFIED, DECLINED, DELETED)
SCHEDULE_DELETION	Schedule account deletion
DELETE	Immediately delete user account

Condition	When Action Executes
NONE	Always
COMMUNICATION_VERIFICATION_MEDIUM	Only if email/mobile is not verified

Retry Mechanism

If retryRequired: true, failed tasks automatically retry:

Retry	Time After Failure
Retry 1	1 minute
Retry 2	10 minutes
Retry 3	1 hour

After 3 failed retries, the task is marked as failed.

Support

Need Help?

For any further assistance, feel free to visit our Support Portal.