Create a Corporation

POST

entities

curl https://production.methodfi.com/entities \
  -X POST \
  -H "Method-Version: 2024-04-04" \
  -H "Authorization: Bearer sk_WyZEWVfTcH7GqmPzUPk65Vjc" \
  -H "Content-Type: application/json" \
  -d '{
    "type": "corporation",
    "corporation": {
      "name": "Alphabet Inc.",
      "dba": "Google",
      "ein": "641234567",
      "owners": [
        {
          "first_name": "Sergey",
          "last_name": "Brin",
          "phone": "+16505555555",
          "email": "sergey@google.com",
          "dob": "1973-08-21",
          "address": {
            "line1": "600 Amphitheatre Parkway",
            "line2": null,
            "city": "Mountain View",
            "state": "CA",
            "zip": "94043"
          }
        }
      ]
    },
    "address": {
      "line1": "1600 Amphitheatre Parkway",
      "line2": null,
      "city": "Mountain View",
      "state": "CA",
      "zip": "94043"
    }
  }'

{
  "id": "ent_A6bmTtFmxQhGQ",
  "type": "corporation",
  "corporation": {
    "name": "Alphabet Inc.",
    "dba": "Google",
    "ein": "641234567",
    "owners": [
      {
        "first_name": "Sergey",
        "last_name": "Brin",
        "phone": "+16505555555",
        "email": "sergey@google.com",
        "dob": "1973-08-21",
        "address": {
          "line1": "600 Amphitheatre Parkway",
          "line2": null,
          "city": "Mountain View",
          "state": "CA",
          "zip": "94043"
        }
      }
    ]
  },
  "error": null,
  "address": {
    "line1": "1600 Amphitheatre Parkway",
    "line2": null,
    "city": "Mountain View",
    "state": "CA",
    "zip": "94043"
  },
  "status": "active",
  "metadata": null,
  "created_at": "2023-10-24T21:26:17.225Z",
  "updated_at": "2023-10-24T21:26:17.225Z"
}

Creates a new corporation Entity. An Entity can be created with an empty object and progressively updated with more information from your end user.

Entities are not checked for existing duplicate Entities.

Body

type

string

required

The type of the Entity. Must be corporation

corporation

object

required

Corporation information of the Entity.

Show properties

corporation.name

string

The legal name of the corporation Entity.

corporation.dba

string

DBA (Doing Business As) name of the corporation Entity.

corporation.ein

string

The EIN of the corporation Entity.

corporation.owners

object[]

The details of the corporation's owners (only include individuals owning 25% or more of the corporation).

Show properties

corporation.owners.first_name

string

The legal first name of the corporation owner.

corporation.owners.last_name

string

The legal last name of the corporation owner.

corporation.owners.phone

string

Mobile phone number of the corporation owner in E.164 format. The number will only be used for KYC / AML verification.

corporation.owners.email

string

Email address of the corporation owner. The email will only be used for KYC / AML verification.

corporation.owners.dob

string

The corporation owner's date of birth in ISO 8601 format.

corporation.owners.address

object

The corporation owner's address.

Show properties

corporation.owners.address.line1

string

The first line of the corporation owner's address.

corporation.owners.address.line2

string

The second line of the corporation owner's address.

corporation.owners.address.city

string

The city of the corporation owner's address.

corporation.owners.address.state

string

The two-letter abbreviation for the state of the corporation owner's address.

corporation.owners.address.zip

string

The ZIP code of the corporation owner's address.

address

object

The Entity's address.

Show properties

address.line1

string

The first line of the Entity's address.

address.line2

string

The second line of the Entity's address.

address.city

string

The city of the Entity's address.

address.state

string

The two-letter abbreviation for the state of the Entity's address.

address.zip

string

The ZIP code of the Entity's address.

Returns

Returns the Entity associated with the ID.

curl https://production.methodfi.com/entities \
  -X POST \
  -H "Method-Version: 2024-04-04" \
  -H "Authorization: Bearer sk_WyZEWVfTcH7GqmPzUPk65Vjc" \
  -H "Content-Type: application/json" \
  -d '{
    "type": "corporation",
    "corporation": {
      "name": "Alphabet Inc.",
      "dba": "Google",
      "ein": "641234567",
      "owners": [
        {
          "first_name": "Sergey",
          "last_name": "Brin",
          "phone": "+16505555555",
          "email": "sergey@google.com",
          "dob": "1973-08-21",
          "address": {
            "line1": "600 Amphitheatre Parkway",
            "line2": null,
            "city": "Mountain View",
            "state": "CA",
            "zip": "94043"
          }
        }
      ]
    },
    "address": {
      "line1": "1600 Amphitheatre Parkway",
      "line2": null,
      "city": "Mountain View",
      "state": "CA",
      "zip": "94043"
    }
  }'

{
  "id": "ent_A6bmTtFmxQhGQ",
  "type": "corporation",
  "corporation": {
    "name": "Alphabet Inc.",
    "dba": "Google",
    "ein": "641234567",
    "owners": [
      {
        "first_name": "Sergey",
        "last_name": "Brin",
        "phone": "+16505555555",
        "email": "sergey@google.com",
        "dob": "1973-08-21",
        "address": {
          "line1": "600 Amphitheatre Parkway",
          "line2": null,
          "city": "Mountain View",
          "state": "CA",
          "zip": "94043"
        }
      }
    ]
  },
  "error": null,
  "address": {
    "line1": "1600 Amphitheatre Parkway",
    "line2": null,
    "city": "Mountain View",
    "state": "CA",
    "zip": "94043"
  },
  "status": "active",
  "metadata": null,
  "created_at": "2023-10-24T21:26:17.225Z",
  "updated_at": "2023-10-24T21:26:17.225Z"
}

Create an Individual Update an Entity

curl https://production.methodfi.com/entities \
  -X POST \
  -H "Method-Version: 2024-04-04" \
  -H "Authorization: Bearer sk_WyZEWVfTcH7GqmPzUPk65Vjc" \
  -H "Content-Type: application/json" \
  -d '{
    "type": "corporation",
    "corporation": {
      "name": "Alphabet Inc.",
      "dba": "Google",
      "ein": "641234567",
      "owners": [
        {
          "first_name": "Sergey",
          "last_name": "Brin",
          "phone": "+16505555555",
          "email": "sergey@google.com",
          "dob": "1973-08-21",
          "address": {
            "line1": "600 Amphitheatre Parkway",
            "line2": null,
            "city": "Mountain View",
            "state": "CA",
            "zip": "94043"
          }
        }
      ]
    },
    "address": {
      "line1": "1600 Amphitheatre Parkway",
      "line2": null,
      "city": "Mountain View",
      "state": "CA",
      "zip": "94043"
    }
  }'

{
  "id": "ent_A6bmTtFmxQhGQ",
  "type": "corporation",
  "corporation": {
    "name": "Alphabet Inc.",
    "dba": "Google",
    "ein": "641234567",
    "owners": [
      {
        "first_name": "Sergey",
        "last_name": "Brin",
        "phone": "+16505555555",
        "email": "sergey@google.com",
        "dob": "1973-08-21",
        "address": {
          "line1": "600 Amphitheatre Parkway",
          "line2": null,
          "city": "Mountain View",
          "state": "CA",
          "zip": "94043"
        }
      }
    ]
  },
  "error": null,
  "address": {
    "line1": "1600 Amphitheatre Parkway",
    "line2": null,
    "city": "Mountain View",
    "state": "CA",
    "zip": "94043"
  },
  "status": "active",
  "metadata": null,
  "created_at": "2023-10-24T21:26:17.225Z",
  "updated_at": "2023-10-24T21:26:17.225Z"
}

API Reference

Entities

Accounts

Payments

Elements

Events

Supporting Endpoints

Body

Returns

API Reference

Entities

Accounts

Payments

Elements

Events

Supporting Endpoints

​Body

​Returns

Body

Returns