Create a project
curl --request POST \
--url https://{your-subdomain}.neetoinvoice.com/api/external/v1/projects \
--header 'Content-Type: application/json' \
--header 'X-Api-Key: <x-api-key>' \
--data '
{
"project": {
"name": "Website Redesign Initiative",
"client_id": "5a2de667-243b-4da3-b090-b698a03d98da",
"tasks_attributes": [
{
"name": "UI Design Phase",
"billable": true,
"hourly_rate": 85,
"checklists_attributes": [
{
"description": "Review wireframe mockups"
}
]
}
],
"hourly_rate": 75.5,
"currency": "USD",
"flat_amount": 5000,
"internal_notes": "This is a priority project with tight deadlines",
"time_round_upto": 15,
"autolock_enabled": true,
"reply_to": "project-manager@example.com",
"enable_approvals": true,
"notify_timesheet_approval_request_instantly": false,
"notify_timesheet_approval_request_weekly": true,
"timesheet_approval_email_notification_day": "friday",
"timesheet_approval_email_notification_time": "17:00",
"autolock_settings": {
"end_of_the_day": true,
"end_of_the_week": false,
"end_of_the_month": false
},
"project_users_attributes": [
{
"user_id": "f448f61d-0834-455c-b9f2-8a69fe159c16",
"role": "project_manager",
"hourly_rate": 75.5,
"approval_type": "manual_approval"
}
]
},
"email": "john@example.com"
}
'const options = {
method: 'POST',
headers: {'X-Api-Key': '<x-api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({
project: {
name: 'Website Redesign Initiative',
client_id: '5a2de667-243b-4da3-b090-b698a03d98da',
tasks_attributes: [
{
name: 'UI Design Phase',
billable: true,
hourly_rate: 85,
checklists_attributes: [{description: 'Review wireframe mockups'}]
}
],
hourly_rate: 75.5,
currency: 'USD',
flat_amount: 5000,
internal_notes: 'This is a priority project with tight deadlines',
time_round_upto: 15,
autolock_enabled: true,
reply_to: 'project-manager@example.com',
enable_approvals: true,
notify_timesheet_approval_request_instantly: false,
notify_timesheet_approval_request_weekly: true,
timesheet_approval_email_notification_day: 'friday',
timesheet_approval_email_notification_time: '17:00',
autolock_settings: {end_of_the_day: true, end_of_the_week: false, end_of_the_month: false},
project_users_attributes: [
{
user_id: 'f448f61d-0834-455c-b9f2-8a69fe159c16',
role: 'project_manager',
hourly_rate: 75.5,
approval_type: 'manual_approval'
}
]
},
email: 'john@example.com'
})
};
fetch('https://{your-subdomain}.neetoinvoice.com/api/external/v1/projects', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://{your-subdomain}.neetoinvoice.com/api/external/v1/projects"
payload = {
"project": {
"name": "Website Redesign Initiative",
"client_id": "5a2de667-243b-4da3-b090-b698a03d98da",
"tasks_attributes": [
{
"name": "UI Design Phase",
"billable": True,
"hourly_rate": 85,
"checklists_attributes": [{ "description": "Review wireframe mockups" }]
}
],
"hourly_rate": 75.5,
"currency": "USD",
"flat_amount": 5000,
"internal_notes": "This is a priority project with tight deadlines",
"time_round_upto": 15,
"autolock_enabled": True,
"reply_to": "project-manager@example.com",
"enable_approvals": True,
"notify_timesheet_approval_request_instantly": False,
"notify_timesheet_approval_request_weekly": True,
"timesheet_approval_email_notification_day": "friday",
"timesheet_approval_email_notification_time": "17:00",
"autolock_settings": {
"end_of_the_day": True,
"end_of_the_week": False,
"end_of_the_month": False
},
"project_users_attributes": [
{
"user_id": "f448f61d-0834-455c-b9f2-8a69fe159c16",
"role": "project_manager",
"hourly_rate": 75.5,
"approval_type": "manual_approval"
}
]
},
"email": "john@example.com"
}
headers = {
"X-Api-Key": "<x-api-key>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text){
"notice_code": "<string>",
"project": {
"name": "<string>",
"created_at": "2023-11-07T05:31:56Z",
"updated_at": "2023-11-07T05:31:56Z",
"identifier": "<string>",
"billing_method": "<string>",
"hourly_rate": 123,
"flat_amount": "<string>",
"status": "<string>",
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"client_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"last_invoice_id": "<string>",
"internal_notes": "<string>",
"time_round_upto": 123,
"autolock_enabled": true,
"autolock_settings": {
"end_of_the_day": "<string>",
"end_of_the_week": "<string>",
"end_of_the_month": "<string>"
},
"currency": "<string>",
"reply_to": "jsmith@example.com",
"enable_approvals": true,
"notify_timesheet_approval_request_instantly": true,
"timesheet_approval_email_notification_day": "<string>",
"timesheet_approval_email_notification_time": "<string>"
}
}API v1 (deprecated)
Create project
Create a project.
POST
/
projects
Create a project
curl --request POST \
--url https://{your-subdomain}.neetoinvoice.com/api/external/v1/projects \
--header 'Content-Type: application/json' \
--header 'X-Api-Key: <x-api-key>' \
--data '
{
"project": {
"name": "Website Redesign Initiative",
"client_id": "5a2de667-243b-4da3-b090-b698a03d98da",
"tasks_attributes": [
{
"name": "UI Design Phase",
"billable": true,
"hourly_rate": 85,
"checklists_attributes": [
{
"description": "Review wireframe mockups"
}
]
}
],
"hourly_rate": 75.5,
"currency": "USD",
"flat_amount": 5000,
"internal_notes": "This is a priority project with tight deadlines",
"time_round_upto": 15,
"autolock_enabled": true,
"reply_to": "project-manager@example.com",
"enable_approvals": true,
"notify_timesheet_approval_request_instantly": false,
"notify_timesheet_approval_request_weekly": true,
"timesheet_approval_email_notification_day": "friday",
"timesheet_approval_email_notification_time": "17:00",
"autolock_settings": {
"end_of_the_day": true,
"end_of_the_week": false,
"end_of_the_month": false
},
"project_users_attributes": [
{
"user_id": "f448f61d-0834-455c-b9f2-8a69fe159c16",
"role": "project_manager",
"hourly_rate": 75.5,
"approval_type": "manual_approval"
}
]
},
"email": "john@example.com"
}
'const options = {
method: 'POST',
headers: {'X-Api-Key': '<x-api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({
project: {
name: 'Website Redesign Initiative',
client_id: '5a2de667-243b-4da3-b090-b698a03d98da',
tasks_attributes: [
{
name: 'UI Design Phase',
billable: true,
hourly_rate: 85,
checklists_attributes: [{description: 'Review wireframe mockups'}]
}
],
hourly_rate: 75.5,
currency: 'USD',
flat_amount: 5000,
internal_notes: 'This is a priority project with tight deadlines',
time_round_upto: 15,
autolock_enabled: true,
reply_to: 'project-manager@example.com',
enable_approvals: true,
notify_timesheet_approval_request_instantly: false,
notify_timesheet_approval_request_weekly: true,
timesheet_approval_email_notification_day: 'friday',
timesheet_approval_email_notification_time: '17:00',
autolock_settings: {end_of_the_day: true, end_of_the_week: false, end_of_the_month: false},
project_users_attributes: [
{
user_id: 'f448f61d-0834-455c-b9f2-8a69fe159c16',
role: 'project_manager',
hourly_rate: 75.5,
approval_type: 'manual_approval'
}
]
},
email: 'john@example.com'
})
};
fetch('https://{your-subdomain}.neetoinvoice.com/api/external/v1/projects', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://{your-subdomain}.neetoinvoice.com/api/external/v1/projects"
payload = {
"project": {
"name": "Website Redesign Initiative",
"client_id": "5a2de667-243b-4da3-b090-b698a03d98da",
"tasks_attributes": [
{
"name": "UI Design Phase",
"billable": True,
"hourly_rate": 85,
"checklists_attributes": [{ "description": "Review wireframe mockups" }]
}
],
"hourly_rate": 75.5,
"currency": "USD",
"flat_amount": 5000,
"internal_notes": "This is a priority project with tight deadlines",
"time_round_upto": 15,
"autolock_enabled": True,
"reply_to": "project-manager@example.com",
"enable_approvals": True,
"notify_timesheet_approval_request_instantly": False,
"notify_timesheet_approval_request_weekly": True,
"timesheet_approval_email_notification_day": "friday",
"timesheet_approval_email_notification_time": "17:00",
"autolock_settings": {
"end_of_the_day": True,
"end_of_the_week": False,
"end_of_the_month": False
},
"project_users_attributes": [
{
"user_id": "f448f61d-0834-455c-b9f2-8a69fe159c16",
"role": "project_manager",
"hourly_rate": 75.5,
"approval_type": "manual_approval"
}
]
},
"email": "john@example.com"
}
headers = {
"X-Api-Key": "<x-api-key>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text){
"notice_code": "<string>",
"project": {
"name": "<string>",
"created_at": "2023-11-07T05:31:56Z",
"updated_at": "2023-11-07T05:31:56Z",
"identifier": "<string>",
"billing_method": "<string>",
"hourly_rate": 123,
"flat_amount": "<string>",
"status": "<string>",
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"client_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"last_invoice_id": "<string>",
"internal_notes": "<string>",
"time_round_upto": 123,
"autolock_enabled": true,
"autolock_settings": {
"end_of_the_day": "<string>",
"end_of_the_week": "<string>",
"end_of_the_month": "<string>"
},
"currency": "<string>",
"reply_to": "jsmith@example.com",
"enable_approvals": true,
"notify_timesheet_approval_request_instantly": true,
"timesheet_approval_email_notification_day": "<string>",
"timesheet_approval_email_notification_time": "<string>"
}
}Deprecated: This is a v1 endpoint and is deprecated. Please use the
v2 API instead. v1 endpoints will be removed
in a future release.
Replace
Learn how to find your subdomain in Workspace subdomain.
{your-subdomain} with your workspace’s subdomain. Learn how to find your subdomain in Workspace subdomain.
Headers
Use the X-Api-Key header to provide your workspace API key. Refer to Authentication for more information.
Body
application/json
Hide child attributes
Hide child attributes
Name of the project.
Example:
"Website Redesign Initiative"
Unique identifier for the client.
Example:
"5a2de667-243b-4da3-b090-b698a03d98da"
The billing strategy used for the project.
Available options:
hourly_project_rate, hourly_person_rate, hourly_task_rate, fixed_price_project List of tasks to create in the project.
Hide child attributes
Hide child attributes
Name of the task.
Example:
"UI Design Phase"
Whether the task is billable.
Example:
true
Hourly rate for the task.
Example:
85
Hourly rate for the project. Required if billing_method is 'hourly_project_rate'.
Example:
75.5
Currency used for billing.
Example:
"USD"
Fixed amount for the project. Required if billing_method is 'fixed_price_project'.
Example:
5000
Internal notes about the project.
Example:
"This is a priority project with tight deadlines"
Time rounding configuration in minutes.
Available options:
0, 6, 15, 30 Example:
15
Whether automatic time entry locking is enabled.
Example:
true
Reply-to email address for project communications.
Example:
"project-manager@example.com"
Whether timesheet approvals are required.
Example:
true
Send instant notifications for approval requests.
Example:
false
Send weekly notifications for approval requests.
Example:
true
Day of the week for weekly approval notifications.
Available options:
sunday, monday, tuesday, wednesday, thursday, friday, saturday Example:
"friday"
Time of day for weekly approval notifications (24-hour format).
Example:
"17:00"
Configuration to automatically lock time entries.
Hide child attributes
Hide child attributes
Lock time entries at the end of each day.
Example:
true
Lock time entries at the end of each week.
Example:
false
Lock time entries at the end of each month.
Example:
false
Users assigned to the project along with their roles.
Hide child attributes
Hide child attributes
Unique ID of the user. Refer to Getting the User ID section for detailed instructions.
Example:
"f448f61d-0834-455c-b9f2-8a69fe159c16"
Role of the user in the project.
Available options:
project_manager, regular_user Example:
"project_manager"
Hourly rate for user.
Example:
75.5
Approval type for timesheet submissions.
Available options:
manual_approval, auto_approval Example:
"manual_approval"
Email of the user creating the project. Required for authentication and user identification.
Example:
"john@example.com"
Response
200 - application/json
OK - Project created successfully
Hide child attributes
Hide child attributes