Create a corporation entity

Creates a new corporation entity, and initiates the KYC / AML verification. The identity verification will almost always be fulfilled synchronously. If a verification takes longer than 5 seconds, the request will be handled asynchronously and a webhook will be fired when there is an update.

Parameters

`type`

string

The type of the entity. Options for corporation entity: c_corporation, s_corporation, llc, partnership, sole_proprietorship.

Required

`corporation`

object

Information of the corporation entity.

Required

`corporation.name`

string

The legal name of the corporation entity.

Required

`corporation.dba`

string

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

Optional

`corporation.ein`

string

The EIN of the corporation entity.

Required

`corporation.owners`

object[]

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

Required

`corporation.owners[].first_name`

string

The legal first name of the corporation owner.

Required

`corporation.owners[].last_name`

string

The legal last name of the corporation owner.

Required

`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.

Required

`corporation.owners[].email`

string

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

Required

`corporation.owners[].dob`

string

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

Required

`corporation.owners[].address`

object

The corporation owner's address.

Required

`corporation.owners[].address.line1`

string

The first line of the corporation owner's address.

Required

`corporation.owners[].address.line2`

string

The second line of the corporation owner's address.

Optional

`corporation.owners[].address.city`

string

The city of the corporation owner's address.

Required

`corporation.owners[].address.state`

string

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

Required

`corporation.owners[].address.zip`

string

The ZIP code of the corporation owner's address.

Required

`address`

object

The entity's address.

Required

`address.line1`

string

The first line of the entity's address.

Required

`address.line2`

string

The second line of the entity's address.

Optional

`address.city`

string

The city of the entity's address.

Required

`address.state`

string

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

Required

`address.zip`

string

The ZIP code of the entity's address.

Required

cURL
Node.js
Python

POST /entities
curl https://production.methodfi.com/entities \
  -X POST \
  -H "Authorization: Bearer sk_WyZEWVfTcH7GqmPzUPk65Vjc" \
  -H "Content-Type: application/json" \
  -d '{
    "type": "c_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"
    }
  }'

POST /entities
const entity = await method.entities.create({
  type: 'c_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',
  },
});

POST /entities
entity = method.entities.create({
  'type': 'c_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': None,
          'city': 'Mountain View',
          'state': 'CA',
          'zip': '94043'
        }
      }
    ]
  },
  'address': {
    'line1': '1600 Amphitheatre Parkway',
    'line2': None,
    'city': 'Mountain View',
    'state': 'CA',
    'zip': '94043'
  }
})

RESPONSE
{
  "id": "ent_y1a9e1fbnJ1f3",
  "type": "c_corporation",
  "individual": null,
  "receive_only": null,
  "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"
  },
  "capabilities": [
    "payments:send",
    "payments:receive"
  ],
  "available_capabilities": [],
  "pending_capabilities": [],
  "error": null,
  "status": "active",
  "metadata": null,
  "created_at": "2020-12-09T00:40:51.107Z",
  "updated_at": "2020-12-09T00:40:51.107Z"
}