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_enabled boolean
Response Request

Whether AI-powered features are enabled for the organization.

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.

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 number of days after invoice date that payment is due.

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
  • de_DE
  • fr_FR
  • es_ES
  • 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.

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.

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 (2 values)

  • 1
    Global overhead
  • 2
    Overhead per subsidiary
owner person
Response

The person who owns the organization account.

owner_id integer
Request

ID of the person who owns the organization account.

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.

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.

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.