Create a company

PUT

/partners/companies/{new_company_name}

Create a new company.

Only Partners with correct permission can create companies. If you believe you will require permissions for this action, please contact RoscoLive support.

Roles with endpoint access

Role	Permission
Partner
Partner View
Custom Partner
Fleet Manager
Group Manager
User
Custom User

Request

Path Params

Body Params multipart/form-data

Responses

🟢201Create company success

application/json

Body

🟠403Company already exists

🟠401Login Required

Request Example

Shell

JavaScript

Java

Swift

curl --location --request PUT '/partners/companies/' \
--form 'company_city="{% faker address.cityName %}"' \
--form 'company_state="{% faker address.stateAbbr %}"' \
--form 'company_zipcode="{% faker address.zipCode %}"' \
--form 'company_address="{% faker address.streetAddress %}"' \
--form 'company_country="{% faker address.country %}"' \
--form 'phone_number="5558675309"' \
--form 'live_active=""' \
--form 'billing_date=""' \
--form 'cutoff_when_overage=""' \
--form 'storage_active=""' \
--form 'trace_active=""' \
--form 'industry_type=""' \
--form 'trial_status=""' \
--form 'trial_date=""' \
--form 'metadata=""'

Response Example

201 - Success

{
    "meta": {
        "code": 201
    },
    "response": {
        "company": {
            "active": true,
            "advanced_profile_settings": true,
            "allow_create_company": true,
            "allow_edit_company": true,
            "asset_deletion_protection": false,
            "billing_date": 1,
            "company_address": "82103 Strosin Villages",
            "company_city": "Strosinmouth",
            "company_country": "Cape Verde",
            "company_key": "A1B2C3D4E5",
            "company_metadata": {
                "data": true
            },
            "company_name": "Dibbert, Kertzmann and Lakin",
            "company_phone_number": "(873) 915-1295 x30529",
            "company_state": "New York",
            "company_type": "CUSTOMER",
            "company_zipcode": "58052",
            "created_by": null,
            "created_by_company_id": 36229,
            "custom_apn": "http://joint-miracle.net",
            "driver_recognition": "manual",
            "event_expiration": "365",
            "geotab_database": "rosco",
            "geotab_email": "Deron.Miller@gmail.com",
            "geotab_path": "https://frivolous-immigration.name",
            "hash": "in",
            "id": 2,
            "industry_type": "Waste Management",
            "live_active": true,
            "owner_company": "Rosco Vision Partner",
            "partner_company": "Rosco Vision Partner",
            "reformat_reminder": 6,
            "speedlimit_audio": false,
            "speedlimit_feature": false,
            "status": "used",
            "storage_active": true,
            "token": "12345678",
            "trace_active": true,
            "trial_status": true,
            "trial_subscribers": "example1@email.com,example2@email.com",
            "using_rosco_sim": true
        }
    },
    "result": "OK"
}

Modified at 2025-10-08 16:58:28

Get a company by ID