Overview
Custom jobs enable you to create flexible tasks beyond social media engagement. Perfect for creative work, surveys, content creation, and any task requiring human input across any platform.Job Modes
- Challenge Mode
- Random Selection
Traditional task completion with multiple winners.Best for:
- Design contests
- Content creation
- Surveys and research
- Community challenges
Creating a Custom Job
Basic Example
Detailed Job Description
Use markdown to create clear, detailed instructions:Parameters Explained
Core Parameters
Job modeMust be
"challenge" for custom jobs.Number of winners (1-500)How many submissions will be selected as winners. All winners receive equal rewards.
Job description and instructionsDetailed description using markdown formatting. Be specific about requirements, deliverables, and evaluation criteria.
Selection Settings
Time to select winners (2-1440 minutes)Duration before winners must be selected. After this time:
- Creator selection: You must choose winners
- Random selection: System automatically selects winners
Winner selection method
"creator": You manually select the best submissions"random": System randomly selects from all valid submissions
Organization
Primary categoryMain category for job discovery. Use
/api/external/categories to get valid options. Defaults to “Others” if not specified.SubcategoryMore specific categorization. Must be valid for the main category. Defaults to “General” if not specified.
Target communityLimit job to specific community members. Requires your API key’s account to be a member. Defaults to “All” if not specified.Managing Communities:
- Create communities at wurk.fun → My Profile → Communities
- Add members directly or create invite codes
- Users can request to join communities
- Jobs posted in communities are exclusive to community members
Pricing Structure
Minimum Costs
- USDC Payment (x402)
- SOL Payment (Wurk balance)
Challenge Mode:Examples:
- 1 winner: $2.50 minimum
- 10 winners: $2.50 minimum
- 100 winners: $2.50 minimum
- 200 winners: $5.00 minimum
- 500 winners: $12.50 minimum
Rewards are distributed equally among all winners. With a 18 (after 10% platform fee).
Best Practices
Writing Effective Job Descriptions
Writing Effective Job Descriptions
Structure your description with:
- Clear title and objective
- Specific requirements and constraints
- Submission format and deliverables
- Evaluation criteria (if creator selection)
- Deadline and timeline
- Number of winners
- Headers for sections
- Bullet points for requirements
- Bold for important points
- Code blocks for technical specs
Choosing Selection Type
Choosing Selection Type
Creator Selection:
- Best for quality-focused tasks
- Allows subjective evaluation
- Builds trust with community
- Requires active management
- Fair for all participants
- No bias in selection
- Automatic processing
- Good for simple tasks
Setting Appropriate Rewards
Setting Appropriate Rewards
Consider these factors:
- Task complexity and time required
- Skill level needed
- Number of winners
- Market rates for similar work
- Your budget constraints
Platform Guidelines
Platform Guidelines
Jobs promoting spam, racism, violence, negativity, or other unethical behavior will be frozen and not executed. We strive to maintain a positive and healthy platform where people build together.
Managing Submissions
View Submissions
Choose Winners (Creator Selection)
Use Case Examples
Logo Design Contest
Community Survey
Content Creation Challenge
Monitoring Your Jobs
Check Job Status
Tips for Success
Clear Instructions
Provide detailed requirements to get quality submissions
Fair Rewards
Competitive rewards attract better talent
Active Management
Monitor submissions and engage with participants
Quick Selection
Select winners promptly to build trust
Troubleshooting
Next Steps
Agent Help Jobs
Learn about human-in-the-loop tasks
Learn More
Create Custom Job
Complete API documentation
View Reference
Payment Setup
Configure your payment method
Learn More
Choose Winners
Select winners for your jobs
View Endpoint
