MPDX Developers
HomeHelp
Production
Production
  • Changelog
  • README
  • org_data_transfer
  • README
    • README
      • Account Lists
        • :Account List
        • Analytics
        • Chalkline Mail
        • Coaches
        • Designation Accounts
        • Donations
        • Donor Accounts
        • Entries
        • Financial Accounts
        • Imports
          • Csv
          • Google
          • Tnt
          • Tnt Data Sync
        • Invites
        • Mail Chimp Account
        • Merge
        • Notification Preferences
          • Bulk
        • Notifications
        • Pledges
        • Prayer Letters Account
        • Users
        • :account_list_id
          • Donations
        • :account_list_id
          • donations
            • Bulk
      • README
        • Impersonation
        • Organizations
        • Resets
      • Announcements
      • Appeals
        • Appeal Contacts
          • Bulk
        • Excluded Appeal Contacts
          • Bulk
      • Background Batches
      • Batch
      • Coaching
        • Answer Sets
        • Answers
        • Questions
      • Constants
      • Contacts
        • Addresses
        • Alma Mater Names
        • Analytics
        • Bulk
        • Church Names
        • Duplicates
        • README
        • Exports
          • Mailing
        • Filters
        • Merges
        • Partner Giving Analysis Filters
        • People
          • Bulk
          • Email Addresses
          • Facebook Accounts
          • Linkedin Accounts
          • Merges
          • Phones
          • Relationships
          • Twitter Accounts
          • Websites
        • Referrals
        • Referrers
        • Tags
          • Bulk
      • Deleted Records
      • Organizations
        • Account Lists
          • Account List Coaches
          • Account List Users
          • Invites
        • Admins
        • Contacts
        • Impersonation
        • Invites
      • Public
        • Designation Accounts
          • Subscriptions
      • README
        • Activity Results
        • Appointment Results
        • Donation Histories
        • Donation Monthly Totals
        • Donor Currency Donations
        • Entry Histories
        • Expected Monthly Totals
        • Goal Progress
        • Monthly Giving Graph
        • Monthly Losses Graphs
        • Partner Giving Analysis
        • People With Anniversaries
        • People With Birthdays
        • Pledge Histories
        • Salary Currency Donations
        • Tag Histories
        • Year Donations
      • Tasks
        • Analytics
        • Comments
        • Filters
        • Tags
      • README
        • Analytics
      • User
        • Account List Coaches
        • Announcements
        • Authenticate
        • Devices
        • Google Accounts
          • Google Integrations
        • Key Accounts
        • Notifications
        • Options
        • Organization Accounts
Powered by GitBook
On this page
  • Organization [POST]
  • Request
  • Parameters
  • Response
  • Fields
  1. README
  2. README
  3. README

Organizations

Organizations Documentation

Organization [POST]

Organization [POST]

Request

Endpoint

POST /api/v2/admin/organizations
Content-Type: application/vnd.api+json

Body

{
  "data": {
    "type": "organizations",
    "attributes": {
      "country": "United States",
      "name": "Cru (Offline)",
      "org_help_url": "https://cru.org"
    }
  }
}

Parameters

Attributes

country

Type string

Description The default country that account lists associated with this organization will be set to

Required No

created_at

Type date

Description The timestamp of when this resource was created

Required No

name

Type string

Description The name of the new organization

Required No

org_help_url

Type string

Description The url of the organization

Required No

updated_at

Type date

Description The timestamp of when this resource was last updated

Required No

updated_in_db_at

Type date

Description This is to be used as a reference for the last time the resource was updated in the remote database - specifically for when data is updated while the client is offline.

Required No

Response

Headers

Content-Type: application/vnd.api+json; charset=utf-8
201 Created

Body

{
  "data": {
    "id": "be6711e1-6401-45c8-b15a-0b32f22e37cd",
    "type": "organizations",
    "attributes": {
      "abbreviation": null,
      "code": null,
      "country": null,
      "created_at": "2022-01-12T17:19:02Z",
      "default_currency_code": "USD",
      "gift_aid_percentage": null,
      "logo": null,
      "name": "Cru (Offline)",
      "oauth": false,
      "updated_at": "2022-01-12T17:19:02Z",
      "updated_in_db_at": "2022-01-12T17:19:02Z"
    }
  }
}

Fields

Attributes

abbreviation

Type string

Description Short name

code

Type string

Description Reference code

country

Type string

Description Country organization is located in primarily

created_at

Type date

Description The timestamp of when this resource was created

default_currency_code

Type string

Description Three letter currency code the organization primarily trades in

gift_aid_percentage

Type number

Description Percentage of gift aid on each received donation

logo

Type string

Description URL of the organization's logo

name

Type string

Description Name of the organization

oauth

Type boolean

Description If the organization is using OAuth to connect its users to MPDX

updated_at

Type date

Description The timestamp of when this resource was last updated

updated_in_db_at

Type date

Description This is to be used as a reference for the last time the resource was updated in the remote database - specifically for when data is updated while the client is offline.

PreviousImpersonationNextResets

Last updated 3 years ago