Organizations

Organizations are the top-level accounts representing a company using Productive. Manage organization-wide settings, branding, localization, and configuration.

Each organization contains subsidiaries, people, projects, and all associated financial and operational data.

Attributes

addons object
Response Request

Active add-ons enabled for the organization.

ai_allowed_models array of string
Response Request

IDs of the AI models allowed for this organization. An empty list allows all models.

ai_enabled boolean
Response Request

Whether AI-powered features are enabled for the organization.

ai_instructions string
Response Request Nullable

Instructions that every AI agent in the organization follows.

allow_time_off boolean
Response Request

Whether time-off tracking is enabled for the organization.

allow_user_email boolean
Response Request

Whether members can use their personal email address as the sender for invoice emails.

analytics_uid object
Response

Google Analytics tracking ID associated with the organization.

autotracking_schedule_id integer
Response Request Enum

ID of the autotracking schedule assigned to this organization for automatic time entry creation.

Enum Values (2 values)

  • 1
    End of day
  • 2
    Start of day
avatar_url string
Response Request

URL of the organization's avatar image (thumbnail size).

billing_email object
Response

Email address used for billing correspondence.

booked_demo boolean
Response Request

Whether the organization has booked a demo with Productive.

company company
Response

The client company linked to the organization.

conflict_resolver_active boolean
Response Request

Whether the scheduling conflict resolver is active, automatically detecting and flagging overbooking conflicts.

create_time_entry_on_timer_start boolean
Response Request

[DESCRIPTION]

currency string
Response Request

Default currency code for the organization (e.g. USD, EUR).

currency_default object
Response

Default currency code used as the base for monetary values.

currency_format_id integer
Response Request Enum

Currency display format preference. Controls how currency symbols and amounts are positioned.

Enum Values (2 values)

  • 1
    symbol
  • 2
    code
currency_normalized object
Response

Normalized currency code used internally.

customer_success_specialist_id integer
Response

ID of the Productive user assigned as the customer success specialist for this organization.

date_format_id integer
Response Request Enum

Date format preference for the organization. Controls how dates are displayed throughout the platform.

Enum Values (7 values)

  • 1
    DD MMM, YYYY
  • 2
    MMM DD, YYYY
  • 3
    YYYY, MMM DD
  • 4
    DD. MMM YYYY
  • 5
    DD.MM.YYYY
  • 6
    MM/DD/YYYY
  • 7
    YYYY-MM-DD
deal_settings object
Response Request

Deal-level settings for time rounding, including rounding method and interval.

decimal_places_id integer
Response Request Enum

Number of decimal places used when displaying monetary values.

Enum Values (4 values)

  • 1
    Two
  • 2
    Three
  • 3
    Four
  • 4
    Five
delivered_budget_recognition_date_id integer
Response Request Enum

Revenue recognition date rule applied to delivered budgets.

Enum Values (6 values)

  • 1
    Date delivered
  • 2
    Budget date
  • 3
    Do not recognize
  • 4
    End date with delivered date fallback
  • 5
    End date with budget date fallback
  • 6
    End date with no recognition fallback
domain_verified object
Response

Whether the custom email domain has been verified for sending invoice emails.

due_days integer
Response Request

Default day offset paired with payment_terms_type (org level): days_after_invoice_date — > 0, after the invoice date; end_of_month — >= 0, after the invoice month's end; due_upon_receipt — ignored.

email_domain_name object
Response

Custom domain name used for the organization's invoice email sender address.

email_key string
Response

Unique email key (inbox key) for receiving emails into the organization.

email_local_name object
Response Request

Local part (username) of the custom invoice email sender address.

email_sender_name object
Response Request

Display name shown as the sender of outgoing invoice emails.

email_type_id integer
Response Request

Email client type used for sending invoices (e.g. SMTP, Sendgrid).

erector_id integer
Response

ID of the Productive user who set up (erected) the organization.

exchange_rate_provider_id integer
Response Enum

Exchange rate data provider used for multi-currency calculations.

Enum Values (4 values)

  • 1
    Open Exchange Rates
  • 2
    HNB
  • 3
    Bank of Lithuania (ECB)
  • 4
    National Bank of Poland (NBP)
expense_markup number
Response Request

Default markup percentage applied to expenses on deals.

expense_settings object
Response Request

Organization-level expense settings (e.g. approval defaults, categories).

facility_costs object
Response Request

Monthly facility cost amount in the organization's default currency.

facility_costs_breakdown object
Response Request

Breakdown of facility costs by category or subsidiary.

facility_costs_default object
Response

Facility costs in the default currency.

facility_costs_normalized object
Response

Facility costs normalized to the base currency.

financial_month_locking_date integer
Response Request

Day of the month on which financial months are locked (1–28).

financial_month_locking_partial_edit boolean
Response Request

Whether partial editing is allowed within a locked financial month.

financial_months object
Response

List of financial months with their start/end dates and lock status.

fiscal_year_start string
Response Request

Start date of the fiscal year if the organization uses a non-calendar fiscal year.

flags object
Response

Feature flags for the organization, keyed by flag name with boolean values.

force_single_sign_on boolean
Response

Whether SSO login is enforced, requiring all users to authenticate via the configured identity provider.

force_two_factor_auth boolean
Response

Whether two-factor authentication is required for all organization members.

invitation_token string
Response

Token used to invite new members to the organization.

invoice_rounding_method_id integer
Response Request

Rounding method applied when generating invoice line item amounts.

invoice_timesheet_export_configuration object
Response Request

Configuration for how timesheet data is exported and attached to invoices.

limited_service_types object
Response Request

Whether service types are restricted to a limited set for the organization.

locale string
Response Request Enum

Locale setting for the organization (e.g. en_US, de_DE).

Enum Values (5 values)

  • en_US
    en_US
  • de_DE
    de_DE
  • fr_FR
    fr_FR
  • es_ES
    es_ES
  • it_IT
    it_IT
man_day_minutes integer
Response Request

Number of minutes in a man-day, used to convert between hours and days in reports and scheduling.

mcp_server_enabled boolean
Response Request

[DESCRIPTION]

meeting_settings object
Response Request

[DESCRIPTION]

Show child attributes
metrics object
Response

Base64-encoded JSON containing UTM attribution metrics for the organization's acquisition source.

name string
Response Request Parameter `sort`

Name of the organization.

notetaker_display_name string
Response Request

[DESCRIPTION]

notetaker_join_message string
Response Request

[DESCRIPTION]

number_format_id integer
Response Request Enum

Number format preference for the organization. Controls how numbers are formatted (e.g. decimal separator).

Enum Values (5 values)

  • 1
    .,
  • 2
    ,.
  • 3
    .
  • 4
    ,
  • 5
    '.
numbering_format_settings object
Response Request

Settings controlling the numbering format for invoices and other financial documents.

onboarding_progress string
Response Request

Tracks the user's progress through the onboarding flow.

open_budget_recognition_date_id integer
Response Request Enum

Revenue recognition date rule applied to open (in-progress) budgets.

Enum Values (6 values)

  • 1
    Date delivered
  • 2
    Budget date
  • 3
    Do not recognize
  • 4
    End date with delivered date fallback
  • 5
    End date with budget date fallback
  • 6
    End date with no recognition fallback
organization_subscription organization subscription
Response

The organization's pricing plan subscription details.

organization_type_id integer
Response

Type of organization (e.g. agency, consultancy).

original_avatar_url object
Response

URL of the original full-size avatar image for this organization before resizing.

overhead boolean
Response Request

Whether overhead cost tracking is enabled for the organization.

overhead_amortization_period integer
Response Request

The number of months over which overhead costs are amortized.

overhead_recalculation_day integer
Response Request

The day of the month on which overhead costs are recalculated.

overhead_subsidiary_switched_at string
Response Request

Timestamp when overhead tracking was switched to per-subsidiary mode.

overhead_type_id integer
Response Request Enum

Type of overhead calculation applied (e.g. fixed, percentage-based).

Enum Values (3 values)

  • 1
    Global overhead
  • 2
    Overhead per subsidiary (by budget)
  • 3
    Overhead per subsidiary (by person)
owner person
Response

The person who owns the organization account.

owner_id integer
Request

ID of the person who owns the organization account.

payment_terms_type string
Response Request Nullable Enum

Organization-wide default payment terms, used for new invoices when no company-level terms are set.

Enum Values (3 values)

  • days_after_invoice_date
    Days after invoice date
  • end_of_month
    End of month
  • due_upon_receipt
    Due upon receipt
proposal_approvals boolean
Response Request

[DESCRIPTION]

quick_start_config string
Response Request

Quick start configuration used during initial setup.

remove_branding boolean
Response Request

Whether the Productive branding is removed from outgoing documents and emails.

request_for_resource_enabled boolean
Response Request

Whether the resource request workflow is enabled, allowing managers to request people for projects.

revenue_recognition_type_id integer
Response Request Enum

Revenue recognition method used for the organization (e.g. percentage of completion, fixed fee).

Enum Values (2 values)

  • 1
    Single date
  • 2
    By budget
rounding_interval_id integer
Response Request Enum

Time rounding interval applied to time entries (e.g. 15 minutes, 30 minutes).

Enum Values (3 values)

  • 1
    6 minutes
  • 2
    15 minutes
  • 3
    30 minutes
rounding_method_id integer
Response Request Enum

Rounding method applied to time entries (e.g. round up, round down, round to nearest).

Enum Values (4 values)

  • 1
    No rounding
  • 2
    Round to nearest
  • 3
    Round up to
  • 4
    Round down to
sample_data_imported_at string
Response

Timestamp when sample data was imported into the organization.

sample_data_reverted_at string
Response

Timestamp when sample data was reverted (removed) from the organization.

save_line_item_snapshots boolean
Response Request

[DESCRIPTION]

scim_bearer_token string
Response

The SCIM bearer token for provisioning users via an identity provider (SCIM 2.0).

self_attribution string
Response

How the organization discovered Productive (self-reported attribution).

self_attribution_comment string
Response

Additional comment or detail on how the organization discovered Productive.

single_sign_on boolean
Response

Whether SAML-based single sign-on is enabled.

subsidiary_count object
Response

Number of active subsidiaries within the organization.

task_due_time_enabled boolean
Response Request

[DESCRIPTION]

time_display_id integer
Response Request Enum

Time display format preference (e.g. 12-hour or 24-hour clock).

Enum Values (2 values)

  • 1
    HH:MM format
  • 2
    Decimal format
time_format_id integer
Response Request Enum

Time format preference for the organization (e.g. decimal hours vs. HH:MM).

Enum Values (2 values)

  • 1
    24 hours clock
  • 2
    12 hours clock
time_locking boolean
Response Request

Whether time locking is enabled, preventing edits to time entries in locked periods.

time_locking_interval integer
Response Request

Number of periods (days or weeks) after which time entries are automatically locked.

time_locking_period_id integer
Response Request Enum

Period unit used for time locking (e.g. days, weeks).

Enum Values (3 values)

  • 1
    Weekly
  • 2
    Monthly
  • 3
    Daily
time_locking_reminders boolean
Response Request

Whether email reminders are sent before time entries are locked.

time_reminder_at integer
Response Request

Hour of the day (0–23) when time reminder emails are sent.

time_reminder_condition integer
Response Request

Minimum tracked time percentage required before a time reminder is triggered.

time_reminder_id integer
Response Request Enum

The ID of the time reminder schedule used by the organization.

Enum Values (5 values)

  • 1
    Same day
  • 2
    Day after
  • 3
    In two days
  • 4
    Last day in week
  • 5
    First day in week
time_reminders boolean
Response Request

Time reminder settings for prompting people to log their time.

timesheet_submission boolean
Response Request

Whether timesheet submission and approval workflow is enabled.

timesheet_submission_reminders boolean
Response Request

Whether reminder emails are sent for pending timesheet submissions.

timesheet_submission_settings object
Response Request

Configuration settings for the timesheet submission workflow.

time_tracking_policies_enabled boolean
Response Request

When true, time tracking policies are enforced across the organization.

time_tracking_policy_id integer
Response Request

The ID of the active time tracking policy for the organization.

time_zone string
Response Request

Default timezone for the organization (Rails TimeZone name, e.g. Eastern Time (US & Canada)).

verification_status_id integer
Response Enum

Verification status of the organization account.

Enum Values (3 values)

  • 1
    Unknown
  • 2
    Verified
  • 3
    Red Flag
verified_at string
Response

Timestamp when the organization account was verified.

week_start_day_id integer
Response Request Enum

First day of the work week for the organization (e.g. Monday, Sunday).

Enum Values (3 values)

  • 1
    Saturday
  • 2
    Sunday
  • 3
    Monday
weight object
Response

Internal weight value used for organization ranking (calculated as 1 / seat count).

working_hours object
Response Request

Default working hours schedule for the organization, defining hours per day of the week.

Examples

Loading example