Get Fields for Deal-Contact Connection crm.deal.contact.fields

If you are developing integrations for Bitrix24 using AI tools (Codex, Claude Code, Cursor), connect to the MCP server so that the assistant can utilize the official REST documentation.

We are still updating this page

Some data may be missing here — we will fill it in shortly.

Scope: crm

Who can execute the method: any user

The method crm.deal.contact.fields returns the description of the fields used by the methods of the crm.deal.contact.* family, namely crm.deal.contact.items.get, crm.deal.contact.items.set, crm.deal.contact.add, etc.

Without parameters.

Example

try
        {
        	const response = await $b24.callMethod(
        		"crm.deal.contact.fields",
        		{}
        	);
        	
        	const result = response.getData().result;
        	if(result.error())
        	{
        		console.error(result.error());
        	}
        	else
        	{
        		console.dir(result);
        	}
        }
        catch(error)
        {
        	console.error('Error:', error);
        }
        
try {
            $response = $b24Service
                ->core
                ->call(
                    'crm.deal.contact.fields',
                    []
                );
        
            $result = $response
                ->getResponseData()
                ->getResult();
        
            if ($result->error()) {
                error_log($result->error());
            } else {
                echo 'Success: ' . print_r($result->data(), true);
            }
        
        } catch (Throwable $e) {
            error_log($e->getMessage());
            echo 'Error fetching deal contact fields: ' . $e->getMessage();
        }
        
BX24.callMethod(
            "crm.deal.contact.fields",
            {},
            function(result)
            {
                if(result.error())
                    console.error(result.error());
                else
                    console.dir(result.data());
            }
        );

How to Use Examples in Documentation

Returned Fields

Field

Description

SORT
integer

Sort index (number). Determines the order in which linked contacts will be displayed in the deal.

IS_PRIMARY
char

[Y/N] Indicates whether the binding is primary. There is always a primary contact in the deal. For it, IS_PRIMARY=Y, for others IS_PRIMARY=N.

CONTACT_ID
integer

Identifier of the contact linked to the deal (number).
Previous
Add multiple contacts
Next
Get contacts associated with the deal